সমস্ত মহান প্রকল্প ব্যবহারকারীর প্রতিক্রিয়া উপর নির্মিত হয়. প্রতিক্রিয়া ট্র্যাক করতে ব্লকলি GitHub সমস্যাগুলি ব্যবহার করে। এই পৃষ্ঠাটি কীভাবে একটি সমস্যা লিখতে হয় যা একজন বিকাশকারীর পক্ষে পড়তে এবং প্রতিক্রিয়া জানাতে সহজ হয়, যা আপনার বাগ রিপোর্ট/বৈশিষ্ট্যের অনুরোধের সমাধান হওয়ার সম্ভাবনা বেশি করে তোলে!
প্রাক কর্ম
প্রশ্ন পেয়েছেন?
আমরা আপনার প্রশ্ন শুনতে ভালোবাসি! কিন্তু GitHub সমস্যাগুলি তাদের জন্য খুব ভাল মাধ্যম নয়। আপনার যদি কোনো প্রশ্ন থাকে, পরিবর্তে আমাদের ডেভেলপার ফোরামে যান। আপনি যদি সেখানে আপনার প্রশ্ন জিজ্ঞাসা করেন তবে আপনি একটি সময়োপযোগী এবং পুঙ্খানুপুঙ্খ প্রতিক্রিয়া পাওয়ার সম্ভাবনা বেশি কারণ এটি বিকাশকারীদের দ্বারা পূর্ণ যারা বছরের পর বছর ধরে ব্লকলি ব্যবহার করে আসছে!
সদৃশ জন্য চেক করুন
আপনি যেকোন ধরণের সমস্যা লিখতে যাওয়ার আগে, একটি ম্যাচিং আগে থেকেই আছে কিনা তা দেখে নেওয়া সবসময়ই ভালো। যদি কেউ তা করে, তাহলে এটি আপনাকে নিজে থেকে লেখার প্রচেষ্টা বাঁচায়! তাই আপনি লেখা শুরু করার আগে, ডুপ্লিকেট বা সম্পর্কিত সমস্যাগুলির জন্য কিছু অনুসন্ধান করুন।
- ব্লকলি-নমুনাগুলিতে অনুসন্ধান করুন
- ব্লকলি কোরে অনুসন্ধান করুন
- ফোরাম অনুসন্ধান করুন
যদি আপনি একটি ম্যাচিং সমস্যা খুঁজে পান, এটি একটি থাম্বস আপ দিন বা আপনার চিন্তার বিশদ বিবরণ একটি মন্তব্য যোগ করুন. এটি বাগ রিপোর্ট এবং বৈশিষ্ট্য অনুরোধের জন্য বিশেষভাবে গুরুত্বপূর্ণ। ডেভেলপাররা যদি দেখেন যে একটি সমস্যা অনেক বেশি মনোযোগ পাচ্ছে, এটিতে কাজ করার সম্ভাবনা বেশি!
একটি বাগ রিপোর্ট করুন
তাহলে আপনি মনে করেন আপনি একটি বাগ আবিষ্কার করেছেন? দারুণ! আমরা বাগ রিপোর্ট শুনতে পছন্দ করি কারণ আমরা চাই এই প্রকল্পটি যতটা সম্ভব স্থিতিশীল হোক। আপনার বাগ সংশোধন করতে সাহায্য করার জন্য এখানে কিছু পদক্ষেপ আপনি অনুসরণ করতে পারেন৷
- সদৃশ জন্য চেক করুন
- প্রমাণ সংগ্রহ করো
- ইস্যুটি সনাক্ত করুন
- আপনার প্রজনন দৃঢ়
- একটি কারণ প্রস্তাব করুন
- আপনার সমস্যা লিখুন!
প্রমাণ সংগ্রহ করো
সাধারণত, আপনার বাগ যত বেশি তথ্য থাকবে তত ভালো। এখানে কয়েকটি জিনিস আপনি প্রদান করতে চাইতে পারেন:
- স্ক্রিনশট বা জিআইএফ সত্যিই সহায়ক হতে পারে যদি একটি বাগ একটি ভিজ্যুয়াল সমস্যা সৃষ্টি করে।
- যদি একটি বাগ শুধুমাত্র নির্দিষ্ট ধরণের ব্লক বা ওয়ার্কস্পেসের কনফিগারেশনকে প্রভাবিত করে তাহলে নমুনা কোডটি কার্যকর।
- আপনার নির্দিষ্ট পরিবেশের বাইরে আপনার বাগ পুনরুত্পাদন করতে সমস্যা হলে একটি হোস্ট করা সাইট দুর্দান্ত৷
ইস্যুটি সনাক্ত করুন
মূল লাইব্রেরি, প্লাগইন, উদাহরণ এবং কোডল্যাবগুলির মধ্যে, আমরা প্রচুর ব্লকলি কোড পেয়েছি। সমস্যাটি ঠিক কোথায় তা জানিয়ে আমাদের সাহায্য করুন।
সমস্যাটি মূলে থাকলে, কোন উপাদান? উদাহরণস্বরূপ, এটি টুলবক্স, বা জুম নিয়ন্ত্রণ বা লাইব্রেরি ব্লকের সাথে একটি সমস্যা হতে পারে। যতটা সম্ভব নির্দিষ্টভাবে বলো.
সমস্যাটি ব্লকলি-স্যাম্পলে থাকলে, কোন প্লাগইন, কোডল্যাব বা উদাহরণে এটি রয়েছে তা বের করুন। আপনি যদি একাধিক জায়গায় একই বাগ খুঁজে পান, তাহলে সেটিও আমাদের জানান।
আপনার প্রজনন দৃঢ়
একটি বাগ কেবলমাত্র পুনরুত্পাদনযোগ্য হলেই ঠিক করা যায়, তাই আপনি একটি সমস্যা জমা দেওয়ার আগে নিশ্চিত করুন যে আপনার বাগটি ঘটানোর জন্য আপনার কাছে একটি শক্ত উপায় রয়েছে।
আপনার ধাপগুলির একটি সংখ্যাযুক্ত তালিকা শেষ করা উচিত যা একজন বিকাশকারীকে কীভাবে বাগ পুনরুত্পাদন করতে হয় তা বলে। উদাহরণ স্বরূপ:
- এক্স কোডল্যাব খুলুন।
- Y পেজে যান।
- Z উদাহরণ কোড চালান।
- খারাপ আচরণ পর্যবেক্ষণ করুন, যা দেখতে W এর মতো।
আপনার সমস্যাটি ব্লকলি কোরে থাকলে, খেলার মাঠে এটি পুনরুত্পাদন করার চেষ্টা করুন।
একটি কারণ প্রস্তাব করুন
আপনি যদি মনে করেন যে আপনি জানেন কেন বাগটি ঘটছে, সেই তথ্যটিও অন্তর্ভুক্ত করুন। আবার, যতটা সম্ভব নির্দিষ্ট হন।
আপনার সমস্যা লিখুন!
আপনার বাগ রিপোর্ট লেখার সময় এসেছে. আপনার সংগ্রহস্থল নির্বাচন করুন:
ইস্যু টেমপ্লেটের সমস্ত বিভাগ পূরণ করতে ভুলবেন না, এমনকি যেগুলি এখানে বিস্তারিত নেই।
একটি বাগ রিপোর্ট করার জন্য আপনার আগ্রহের জন্য ধন্যবাদ, এবং খুশি সমস্যা লেখার জন্য!
এরপর কি?
- আপনার বাগ রিপোর্ট স্বয়ংক্রিয়ভাবে triage জন্য ট্যাগ করা হয়.
- Blockly টিমের অন-কল সদস্য একবার দেখবেন এবং সম্ভবত স্পষ্ট প্রশ্ন জিজ্ঞাসা করবেন। তারা লেবেলও যোগ করবে, যা আমরা আমাদের বাগগুলিকে সংগঠিত রাখতে ব্যবহার করি।
- সমস্যাটিকে "হেল্প ওয়ান্টেড" হিসাবে চিহ্নিত করা যেতে পারে, এই ক্ষেত্রে আপনি এটি দাবি করতে পারেন এবং এটিতে কাজ শুরু করতে পারেন৷
- সমস্যাটি সমাধানের জন্য ব্লকলি দলের একজন সদস্যকে নিয়োগ করা হতে পারে।
- এটি কখন করা হবে তা নির্দেশ করতে সমস্যাটিকে একটি ত্রৈমাসিক মাইলফলক দিয়ে চিহ্নিত করা হতে পারে।
- সমস্যাটি আইসবক্স মাইলস্টোনের মধ্যে রাখা যেতে পারে, যার অর্থ আমরা অদূর ভবিষ্যতে এটিতে কাজ করার ইচ্ছা রাখি না।
- কম-ফ্রিকোয়েন্সি সমস্যা বা পরিচিত ওয়ার্কঅ্যারাউন্ড সহ বাগগুলির জন্য এটি ঘটতে পারে।
- আপনি এখনও Iceboxed সমস্যা নিয়ে কাজ করতে পারেন।
- সমস্যাটি বাগ ব্যাশ ব্যাকলগ মাইলস্টোনের মধ্যে রাখা হতে পারে, যার অর্থ এটি জরুরী নয় কিন্তু আমরা এখনও এটি ঠিক করতে চাই৷
- প্রতি ত্রৈমাসিকের শেষে দলটি বাগ ব্যাশ ব্যাকলগ মাইলফলক থেকে টানা বাগগুলির উপর কাজ করে কয়েক সপ্তাহ ব্যয় করে।
- প্রয়োজনে সমস্যাটিকে ব্লকলি কোর থেকে ব্লকলি-স্যাম্পলে (বা বিপরীত দিকে) সরানো হতে পারে।
- সমস্যা বন্ধ হয়ে যেতে পারে।
বৈশিষ্ট্য অনুরোধ
ব্লকলিকে আরও ভাল করার জন্য আপনি কি কিছু পরিবর্তন করতে চান? আপনি একটি প্লাগইন, উদাহরণ, বা কোডল্যাব জন্য একটি ধারণা আছে? হয়তো ইতিমধ্যেই আপনার পছন্দের একটি আছে এবং আপনি এটিকে উন্নত করার একটি উপায় নিয়ে এসেছেন৷ যদি তাই হয় তাহলে আপনি সঠিক জায়গায় এসেছেন! এখানে একটি দুর্দান্ত বৈশিষ্ট্য অনুরোধ তৈরি করতে সহায়তা করার জন্য পদক্ষেপগুলি রয়েছে যা একটি প্রতিক্রিয়া পায়৷
- সদৃশ জন্য চেক করুন
- প্রয়োজনীয়তা পরীক্ষা করুন
- আপনার চিন্তা সংগ্রহ করুন
- আপনার বৈশিষ্ট্য অনুরোধ লিখুন!
প্রয়োজনীয়তা পরীক্ষা করুন
আমরা প্রতিটি একক ধারণাকে এই সংগ্রহস্থলে প্রবেশ করার অনুমতি দিতে চাই! কিন্তু দুঃখজনকভাবে আমরা শুধুমাত্র মানুষ, তাই আমরা কি ধরনের অনুরোধ করব সে সম্পর্কে আমাদের কিছু নির্দেশিকা রয়েছে।
এখানে প্রতিটি প্রকল্পের বিভিন্ন বিভাগের নির্দেশিকা রয়েছে:
- ব্লকলি কোর
- প্লাগইন
- উদাহরণ: শুধুমাত্র এক বা দুটি ব্লকলি বৈশিষ্ট্য কীভাবে ব্যবহার করবেন তা দেখান।
- কোডল্যাব: কিভাবে একটি একক কাজ সম্পূর্ণ করতে হয় বা একটি একক আচরণ বাস্তবায়ন করতে হয় তা দেখান।
কিন্তু এগুলি কঠিন এবং দ্রুত নিয়ম নয়। আপনি আপনার বৈশিষ্ট্য অনুরোধ তৈরি করতে সময় দেওয়ার আগে আমরা কী খুঁজছি সে সম্পর্কে আপনাকে ধারণা দেওয়ার জন্যই তারা।
আপনি যদি নিশ্চিত না হন যে কিছু মানানসই কিনা, আমাদের ডেভেলপার ফোরামে পোস্ট করার চেষ্টা করুন৷ এবং মনে রাখবেন, এমনকি যদি আপনার ধারণাটি গৃহীত না হয়, তবুও আমরা এটিকে তৃতীয় পক্ষের প্লাগইন বা টিউটোরিয়াল হিসাবে তৈরি করতে চাই!
আপনার চিন্তা সংগ্রহ করুন
আপনি এগিয়ে যেতে এবং জমা দেওয়ার আগে আপনার ধারণাটি 100% টিনসেল এবং ডায়াগ্রাম দিয়ে তৈরি করার দরকার নেই, তবে আপনি যা খুঁজছেন তার একটি দৃঢ় ধারণা থাকা উচিত। আপনি লিখতে শুরু করার আগে এইগুলি চিন্তা করার জন্য কিছু ভাল প্রশ্ন:
- কেন আমি এই বৈশিষ্ট্য চাই?
- এই বৈশিষ্ট্য একটি সমস্যা সমাধান করে?
- এই বৈশিষ্ট্যের জন্য অভিপ্রেত শ্রোতা কে?
- কেন এই বৈশিষ্ট্য তাদের পরিবেশন করে?
- একই জিনিস অর্জন করতে পারে যে কিছু বিকল্প বিকল্প কি কি?
একবার আপনি এই জিনিসগুলি বের করে নিলে, আপনি একটি ভাল বৈশিষ্ট্যের অনুরোধের বেশিরভাগ উপায়ে থাকবেন!
আপনার বৈশিষ্ট্য অনুরোধ লিখুন!
এখন আপনি আপনার বৈশিষ্ট্য অনুরোধ লিখতে প্রস্তুত. আপনার সংগ্রহস্থল নির্বাচন করুন:
ইস্যু টেমপ্লেটের সমস্ত বিভাগ পূরণ করতে ভুলবেন না, এমনকি যেগুলি এখানে বিস্তারিত নেই।
একটি বৈশিষ্ট্য অনুরোধ জমা দিতে আপনার আগ্রহের জন্য আপনাকে ধন্যবাদ, এবং খুশি সমস্যা লেখা!
এরপর কি?
- আপনার বৈশিষ্ট্য অনুরোধ স্বয়ংক্রিয়ভাবে triage জন্য ট্যাগ করা হয়.
- Blockly টিমের অন-কল সদস্য একবার দেখবেন এবং সম্ভবত স্পষ্ট প্রশ্ন জিজ্ঞাসা করবেন। তারা লেবেলও যোগ করবে, যা আমরা আমাদের বাগগুলিকে সংগঠিত রাখতে ব্যবহার করি।
- বৈশিষ্ট্যটিকে "হেল্প ওয়ান্টেড" হিসাবে চিহ্নিত করা যেতে পারে, এই ক্ষেত্রে আপনি এটি দাবি করতে পারেন এবং এটিতে কাজ শুরু করতে পারেন৷
- বৈশিষ্ট্যটি বাস্তবায়নের জন্য Blockly দলের একজন সদস্যকে বরাদ্দ করা হতে পারে।
- প্রয়োজনে বৈশিষ্ট্য অনুরোধটি ব্লকলি কোর থেকে ব্লকলি-নমুনাগুলিতে (বা বিপরীত দিকে) সরানো যেতে পারে।
- বৈশিষ্ট্য অনুরোধটি বন্ধ হয়ে যেতে পারে, সেক্ষেত্রে আপনার কাছে এটিকে তৃতীয় পক্ষের প্লাগইন হিসাবে প্রয়োগ করার বিকল্প রয়েছে।