# পরিচালনা নির্দেশাবলি

যারা আমাদের প্রকল্প পরিচালনা ও বজায় রাখতে সহায়তা করতে প্রকল্পে রক্ষণাবেক্ষণকারী হিসাবে যোগদান করতে চান তাদের জন্য আমাদের এই পথ নির্দেশিকা। (দ্রষ্টব্যঃ এটি **নবীনদের** জন্য নয়।)

## অনুবাদ

এই পৃষ্ঠাটি [অন্যোন্য ভাষায়ও](../README.md) অনুবাদ করা হয়েছে।

| [ইংরেজি](../../maintainer_guide.md) | [বাংলা](maintainer_guide.ben.md) | [জার্মানি](maintainer_guide.ger.md) | [ইটালিয়ান](maintainer_guide.ita.md) | [জাপানিজ](maintainer_guide.jpn.md) |
| :---: | :---: | :---: | :---: | :---: |
| [পর্তুগিজ](maintainer_guide.por.md) |

> আমাদের প্রকল্পের নথিগুলোর বিভিন্ন ভাষায় রুপান্তরকে আমরা আন্তরিকভাবে স্বাগত জানাই। অনুবাদ সম্বন্ধীয় অবদানের জন্যঃ [`অনুবাদ সহায়ক`](../README.md) -টি পরুন।

---

## উদ্দেশ্য

আমাদের প্রকল্পের অবদানকারিদের পুল রিকোয়েস্ট এর দ্রুততম প্রতিক্রিয়া দেওয়াই আমাদের মূল উদ্দেশ্য। এর প্রাথমিক অর্থ হল কোড রিভিউ দেওয়া এবং গৃহীত পিআর আমাদের মুল কোডের সাথে একত্রিত করা। এছাড়া আমাদের প্রকল্পের সবকিছু ঠিকভাবে কাজ করছে কিনা বা আমাদের প্রকল্পে অবদানকারীদের জন্য এটি যথেষ্ট সহায়ক এবং দরকারী হছে কিনা আমরা তা নিশ্চিত করতে পারি।

## এটা কার জন্য?

গিট বা গিটহাব এ হালকা দক্ষতা আছে এমন যে কেউ আমাদের সাথে অংশগ্রহণ করতে পারেন। আপনার অভিজ্ঞ হওয়ার প্রয়োজন নেই, কারণ এই পথ নির্দেশিকাটি একেবারে নবীনদের উদ্দেশ্য করে বানানো। এটি একটি সক্রিয় প্রকল্প যা নিয়মিত অবদান গ্রহণ করে এবং এটি অনেক লোককে তাদের প্রথম ওপেন সোর্স অবদান রাখতে সাহায্য করে৷ এই প্রকল্পের একজন রক্ষণাবেক্ষণকারী যুক্ত হওয়া বলতে আমাদের প্রকল্পের অবদানকারীদের একটি ভাল প্রথম অভিজ্ঞতা প্রদান করা এবং তাদের আরও অবদান রাখতে উৎসাহ প্রদান করা নিশ্চিত করতে সহায়তা করে।

আপনি এই প্রকল্পে যতটা বেশি অথবা কম অবদান রাখতে পারেন। আশা করি আমরা একসাথে এই প্রকল্পকে সুচারুভাবে চালাতে পারব।

## পদ্ধতি

- প্রকল্পের পুল রিকোয়েস্ট বিভাগে যান, সবচেয়ে পুরানো পুল রিকোয়েস্ট দিয়ে শুরু করুন যা `changes requested` লেবেলটি নেই।
- একটি পিআর খুলুন এবং ফাইল পরিবর্তন ট্যাবে যান এবং একটি কোড পর্যালোচনা শুরু করুন।
- পিআর পরীক্ষা করুন এবং নিশ্চিত করুন যে এটি টিউটোরিয়ালের ধাপসমুহ অনুসরণ করছে।
- নিশ্চিত করুন যে HTML, লিঙ্ক এবং ডেটা সব সঠিক রয়েছে। আরও নিশ্চিত করুন যে কার্ডটি ফাইলের শুরুতে যেখানে থাকা উচিত (১১৭ নং লাইনের পর) সেখানে অবস্থিত আছে৷
- পরবর্তীতে কোনো দ্বন্দ্বের জন্য চেক করুন. দ্বন্দ্ব ঠিক করতে PR শাখায় `master` মার্জ করুন। যখন PR -টি বেশি পুরনো হয়ে যায় এবং কয়েকটি PR প্রকল্পের পুরনো সংস্করণ ব্যবহার করে তখন এটিতে বিরোধ দেখা দেয়।
- বিরোধের সমাধান করুন। সাধারণত আপনাকে ফর্ক তৈরির পর থেকে যোগ করা কার্ডের উপরে নতুন কার্ডটি যোগ করতে হবে।
- অন্য সব কিছু ঠিক থাকলে, PR অনুমোদন করুন, অবদানকারীর অবদানের জন্য তাদের ধন্যবাদ জানিয়ে একটি বার্তা লিখুন (মনে রাখুন যে তারা নবীন এবং আপনার উৎসাহ থেকে তারা উপকৃত হবে)।
- পুল রিকোয়েস্টকে `master`-এ মার্জ করুন।

## পরিবর্তনের জন্য অনুরোধ করুন

- কখনও কখনও পিআর-এর সাথে যেকোন কিছু যেখানে টিউটোরিয়ালটি সঠিকভাবে অনুসরণ করা হয়নি (এবং সাধারণ মার্জ দ্বন্দ্ব নয়) যেমন ভুল ব্রাঞ্চিং, ভাঙা HTML, অনুপস্থিত তথ্য, ভুল জায়গায় কার্ড রাখা ইত্যাদি সমস্যা থাকে যা অবদানকারীর দ্বারা ঠিক করা উচিত।
- GitHub-এ একটি কোড পর্যালোচনা শুরু করুন এবং পরিবর্তনের অনুরোধ করুন। যতটা সম্ভব বর্ণনামূলক হওয়ার চেষ্টা করুন, সঠিক লাইনটি মন্তব্য করুন, সমস্যাটি ঠিক কী এবং কীভাবে এটি ঠিক করা যায় তা তাদের বলুন এবং তাদের উৎসাহিত করুন যে এটি PR পর্যালোচনা প্রক্রিয়ার একটি স্বাভাবিক অংশ।
- আপনি প্রস্তুত হলে পর্যালোচনা জমা দিন।
- যদি অবদানকারীর ফলো-আপ প্রশ্ন থাকে যা আপনি সাহায্য করতে পারেন সেজন্য, PR কথোপকথনের উপর নজর রাখুন। আমাদের উদ্দেশ্য হল প্রত্যেকে যাতে তাদের অবদান সফলভাবে সম্পন্ন করতে পারে, তাই আমরা তাদের সেখানে সমস্ত পথ দেখানোর চেষ্টা করি।
- একবার তারা অনুরোধ করা পরিবর্তনগুলি ঠিক করে দিলে, পিআরকে `master`-এ মার্জ করে দিন।

অনুগ্রহ করে, সর্বদা পরীক্ষা করুন যে পরিবর্তনগুলি প্রকল্পটি ভঙ্গ করেনি এবং লাইভ পৃষ্ঠাটি এখনও প্রত্যাশিত হিসাবে কাজ করে। একত্রিত হওয়ার আগে স্থানীয়ভাবে পরিবর্তনগুলি পরীক্ষা করা সর্বদা সর্বোত্তম এবং সন্দেহজনক মনে হয় এমন কিছু একত্রিত করবেন না।

## উপকরণ

যদি প্রচুর পরিমাণে PR না থাকে তবে এই সমস্ত প্রক্রিয়া সরাসরি প্রকল্পের GitHub পৃষ্ঠায় করা যেতে পারে।  
যাইহোক, কিছু PR ঝুলে থাকা অস্বাভাবিক নয় এবং তখনই অনিবার্যভাবে কিছু মার্জ দ্বন্দ্ব হবে। আপনি পার্থক্য দেখতে এবং বিরোধগুলি সমাধান করতে আপনার পরিচিত যে কোনও সরঞ্জাম ব্যবহার করতে পারেন।
আমি [GitKraken](https://www.gitkraken.com/download)এর মতো একটি টুল ব্যবহার করার পরামর্শ দিব। যখন গিটহাবে PR নিয়ে কাজ করতে হয়, তখন এই সফটওয়্যারটি প্রকল্প ব্যবস্থাপনা সহজ করে তোলে। GitKraken ডাউনলোড করুন, প্রকল্পটি ক্লোন করুন। আপনার কোড এডিটর এবং GitKraken-এর ইন্টিগ্রেটেড মার্জ কনফ্লিক্ট টুলের সংমিশ্রণ আপনাকে দ্রুত PRs, দ্বন্দ্বের সমাধান এবং মার্জ করার সম্পূর্ণ নিয়ন্ত্রণ দেয়।

প্রজেক্টে Prettier স্টাইলার দ্বারা নিয়ন্ত্রিত যার ফলে অবদানকারী যেভাবেই তার PR জমা দেক না কেন, প্রকল্পটি সবসময় একই ইন্ডেন্টেশন এবং শৈলীর সাথে বজায় থাকে। আপনি যদি লক্ষ্য করেন যে HTML ফাইলটি অগোছালো দেখাচ্ছে তবে প্রজেক্ট রুটে নিচে উল্লেখিত কমান্ডটি প্রয়োগ করুন।

```js
npx prettier --write index.html
```

এটি আমাদের প্রকল্পের মুল ফাইলটি স্টাইল করার চেষ্টা করবে এবং যদি তা না করতে পারে তবে এটি আপনাকে ত্রুটিগুলি দেখাবে। কখনও কখনও একটি অনুপস্থিত ক্লোজিং ট্যাগ বা ভাঙা HTML ভুলবশত আমাদের কোডে চলে আসে এবং তা চিহ্নিত এবং ঠিক করার জন্য এটি একটি ভাল উপায়।

আপনি যদি কখনও কোন কিছু নিয়ে সন্দেহ হয়ে থাকে তবে আপনি সর্বদা আমাকে বা প্রকল্পের অন্যান্য রক্ষণাবেক্ষণকারীদেরকে ডাক দিতে পারেন বা আমাকে [টুইটারে](https://twitter.com/Syknapse) বার্তা প্রেরণ করতে পারেন।

## আমাদের সাথে যোগদান করুন

এই প্রকল্পটিকে বড় করার জন্য আমাদের সাথে যোগ দিন। [টুইটারে](https://twitter.com/Syknapse) আমার সাথে যোগাযোগ করুন এবং আমাকে আপনার GitHub ব্যবহারকারীর নাম পাঠান যাতে আমি আপনাকে একজন রক্ষণাবেক্ষণকারী হিসেবে আম্মাদের প্রকল্পে যোগ করতে পারি। নিচের বাটনটির সাহায্যে আপনি আমাদের ডিসকর্ড কমিউনিটিতে যুক্ত হতে পারেনঃ

[![Discord](https://badgen.net/discord/online-members/tWkvS4ueVF?label=আমাদের%20ডিসকর্ড%20সার্ভারে%20যুক্ত%20হন&icon=discord)](https://discord.gg/tWkvS4ueVF 'আমাদের ডিসকর্ড সার্ভারে যুক্ত হন।')
