পুল রিকোয়েস্ট (PR) হলো Exercism কোডবেসের কোনো অংশে আপনার প্রস্তাবিত পরিবর্তন জমা দেওয়ার উপায়।
আপনি যদি এটি পড়ছেন এবং একটি PR তৈরি করছেন, তাহলে আপনাকে ধন্যবাদ!
এই নির্দেশিকাটির লক্ষ্য হলো PR-এর অ-প্রযুক্তিগত দিকটিতে আপনাকে সাহায্য করা, যাতে আপনার অভিজ্ঞতা দুর্দান্ত হয় এবং একই সঙ্গে আপনি আমাদের মেইনটেইনার দলকেও সাহায্য করতে পারেন।
কী আশা করা যায়
PR-এর প্রক্রিয়াটি নিম্নরূপ:
- আপনি একটি PR জমা দেন
- একজন বা একাধিক মেইনটেইনার PR-টি খতিয়ে দেখেন এবং পরামর্শমূলক মন্তব্য রেখে যান।
কোনো কোনো ক্ষেত্রে তাঁরা গোটা PR-টি নিয়ে আলোচনা করতে পারেন, এটি যোগ করা সঠিক হবে কি না তা বুঝে নেওয়ার জন্য।
- আপনার PR মার্জ করা হয় এবং ওয়েবসাইটে আপনাকে রেপুটেশন দেওয়া হয়।
অথবা আপনার PR বন্ধ করে দেওয়া হয়।
কীভাবে PR মার্জ করানো যায়?
শুরুতে কিছু কাজ আপনি নিজেই করতে পারেন, যাতে আপনার PR কম পরিবর্তনেই মার্জ হওয়ার সম্ভাবনা বেড়ে যায়।
সবচেয়ে গুরুত্বপূর্ণ হলো, PR জমা দেওয়ার আগেই নিশ্চিত হয়ে নেওয়া যে আপনি যে পরিবর্তনগুলো করছেন তা মেইনটেইনাররা স্বাগত জানাবেন।
এটি করার সবচেয়ে সহজ উপায় হলো, প্রথমে GitHub-এ একটি ইস্যু খুলে ব্যাখ্যা করা যে আপনি কী করতে চান, এবং জিজ্ঞাসা করা যে মেইনটেইনাররা এই পরিবর্তনগুলোতে রাজি কি না।
Exercism ওয়েবসাইটে যদি কোনো টাস্ক পান, তাহলে নতুন করে ইস্যু খোলার দরকার নেই।
আপনি কাজটি করবেন বলে বিদ্যমান ইস্যুতে মন্তব্য করতে পারেন, তারপর এগিয়ে যেতে পারেন।
দ্বিতীয় বিষয়টি নিশ্চিত করা হলো, PR খোলার সময় তার মধ্যে একটি স্পষ্ট বিবরণ লিখে যাওয়া।
বর্ণনাহীন PR মেইনটেইনারদের জন্য ভীষণভাবে বিরক্তিকর, কারণ কোড পড়ার সময় তাঁদের কোনো প্রেক্ষাপট থাকে না।
আমাদের বলুন আপনি কেন পরিবর্তনগুলো করেছেন, PR-টি যে ইস্যু নিয়ে সেটির লিংক দিন, যে ট্রেড-অফগুলো করতে হয়েছে সেগুলো ব্যাখ্যা করুন, ইত্যাদি।
সবশেষে নিশ্চিত হোন, আপনার PR-এ কেবল একটি উন্নতির সঙ্গে সম্পর্কিত পরিবর্তনই আছে।
একাধিক উন্নতি থাকলে সেগুলো একাধিক PR-এ ভাগ করে দিন।
এতে মেইনটেইনারদের রিভিউ করা সহজ ও দ্রুত হয়, আর আপনার জীবনও সহজ হয়ে যায়।
কতক্ষণ অপেক্ষা করা উচিত?
সাধারণত মেইনটেইনাররা কয়েক দিনের মধ্যে আপনার PR রিভিউ করে ফেলেন।
প্রথম সপ্তাহে অনুগ্রহ করে অতিরিক্ত মন্তব্য দিয়ে PR-টি বারবার উপরে তুলে আনার চেষ্টা করবেন না। আমাদের মেইনটেইনাররা স্বেচ্ছাসেবক এবং ব্যস্ত মানুষ; তাঁরা যত দ্রুত সম্ভব রিভিউয়ের সময় বের করে নেবেন।
৭ দিনের মধ্যে কোনো উত্তর না পেলে অনুগ্রহ করে PR-এ একটি নতুন মন্তব্যে @exercism/reviewers ট্যাগ করুন; তাহলে বিষয়টি আরও বড় একটি দলের নজরে আসবে।
Exercism-এ অবদান রাখার জন্য আবারও আপনাকে ধন্যবাদ।
আমরা আশা করি এটি আপনার জন্য আনন্দদায়ক ও মূল্যবান অভিজ্ঞতা হবে!
