কন্ট্রিবিউটরদের জন্য পুল রিকোয়েস্ট গাইড


Exercism-এ অবদান রাখতে চাওয়ার জন্য আপনাকে ধন্যবাদ! একটি পুল রিকোয়েস্ট তৈরি করার আগে অনুগ্রহ করে কীভাবে একটি দুর্দান্ত পুল রিকোয়েস্ট তৈরি করবেন গাইডটি পড়ে নিন। এই গাইডের লক্ষ্য হলো পুল রিকোয়েস্টের অ-টেকনিক্যাল দিকগুলোতে আপনাকে সাহায্য করা, যাতে আপনি একটি ভালো অভিজ্ঞতা পান এবং একইসাথে আমাদের মেইনটেইনিং টিমকেও সাহায্য করতে পারেন।

এই ডকুমেন্টে বিভিন্ন ধরনের পুল রিকোয়েস্টের জন্য কিছু অতিরিক্ত, Exercism-নির্দিষ্ট নির্দেশিকা রয়েছে।

অনুশীলনীর পুল রিকোয়েস্ট

এই ধরনের অনুশীলনী ঘিরে থাকা অনেক নিয়মের কারণে একটি কনসেপ্ট অনুশীলনী বা প্র্যাকটিস অনুশীলনীর পুল রিকোয়েস্ট তৈরি করা কঠিন ও ভীতিকর মনে হতে পারে। এজন্যই একজন মেইনটেইনারের রিভিউ করতে দুই থেকে তিন ঘণ্টা লেগে যেতে পারে এবং ডজনখানেক মন্তব্য আসতে পারে।
আপনাকে সাহায্য করতে আপনার পুল রিকোয়েস্টে একজন প্রধান রিভিউয়ার মন্তব্য করবেন।

রিভিউয়ের মন্তব্যের সংখ্যা দেখে হতাশ হবেন না; আপনি এবং প্রধান রিভিউয়ার দুজনেই সন্তুষ্ট হন এমন কিছুতে পৌঁছানোর আগে একটি অনুশীলনী কয়েকবার নতুন করে লেখার মধ্য দিয়ে যাওয়াটা পুরোপুরি স্বাভাবিক।

পরামর্শ

প্রক্রিয়াটিকে আরও মসৃণ করতে এখানে কিছু পরামর্শ রইল।

ডকুমেন্টেশন পড়ুন

একটি অনুশীলনীর পুল রিকোয়েস্ট তৈরির আগে অবশ্যই যথাক্রমে কনসেপ্ট অনুশীলনীর ডকুমেন্টেশন এবং প্র্যাকটিস অনুশীলনীর ডকুমেন্টেশন পড়ে নিন। আগে থেকে ডকুমেন্টেশন পড়া অত্যন্ত সাহায্য করে, কারণ তাহলে রিভিউয়ে কম মন্তব্য আসে এবং আপনার পুল রিকোয়েস্ট অনেক তাড়াতাড়ি মার্জ হয়।

বিদ্যমান অনুশীলনীগুলো দেখে নিন (যদি থাকে)

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

প্র্যাকটিস অনুশীলনীর পুল রিকোয়েস্ট

পরিবর্তনটি আদৌ problems-specifications-এ রাখা উচিত কি না ভেবে দেখুন

প্র্যাকটিস অনুশীলনীর কিছু বিষয়বস্তু (যেমন তার পরিচিতি) আসে তার (শেয়ার করা) মেটাডেটা থেকে, যা problems-specifications রিপোতে সংজ্ঞায়িত করা আছে। আপনি যদি এমন কোনো বিষয়বস্তু আপডেট করার কথা ভাবেন, তাহলে ভেবে দেখুন পরিবর্তনটি অন্য ট্র্যাকেরও উপকারে আসতে পারে কি না। যদি আসে, তাহলে অনুগ্রহ করে বদলে অনুশীলনীর মেটাডেটায় problems-specifications রিপোতে একটি পুল রিকোয়েস্ট খুলুন।

সাধারণ পরামর্শ

অনুরোধ ছাড়া রিভিউ করা থেকে বিরত থাকুন

সব পুল রিকোয়েস্টের রিভিউ ট্র্যাকের একজন (বা একাধিক) মেইনটেইনার করেন, কারণ রিপোর সব পরিবর্তনে অনুমোদন দেওয়ার দায়িত্ব তাদেরই। মেইনটেইনাররা নিজেরাই রিভিউ করলে পুল রিকোয়েস্টের লেখকের কাছে পরস্পরবিরোধী ফিডব্যাক যাওয়াও এড়ানো যায়।

রিভিউয়ে সহায়তা দেওয়ার জন্য একটি মন্তব্য রাখতে (বিশেষত বড় পুল রিকোয়েস্টের ক্ষেত্রে) বা আপনার চোখে কোনো কিছু ভুল মনে হলে প্রশ্ন তুলতে আপনি অবশ্যই স্বাগত।