নমুনা অবদান

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

জানা দরকার

পিআর তৈরি করার জন্য ব্লকলি-স্যাম্পল সম্পর্কে আপনার যা জানা দরকার তার একটি সংক্ষিপ্ত বিবরণ এখানে দেওয়া হল।

• কার্যকরী শাখাটি প্রধান এবং সমস্ত পিআর প্রধানের বিপরীতে করা উচিত।
• ব্লকলি-স্যাম্পল এর রুট লেভেলে npm install চালান, পৃথক প্লাগইন লেভেলে নয়। ব্লকলি-স্যাম্পল হল একটি মনোরেপো, যার অর্থ এটি একই রিপোজিটরিতে একাধিক প্যাকেজ ধারণ করে এবং রুট লেভেলে ইনস্টল করা Lerna এর সাথে মনোরেপো পরিচালনার জন্য ওয়ার্কফ্লোর অংশ।
• ব্যবহৃত ভাষার উপর নির্ভর করে কোডটি অবশ্যই গুগলের জাভাস্ক্রিপ্ট স্টাইল গাইড অথবা টাইপস্ক্রিপ্ট স্টাইল গাইডের সাথে সঙ্গতিপূর্ণ হতে হবে।
• আপনার কমিট বার্তাগুলিতে প্রচলিত কমিট ব্যবহার করুন এবং অনুরোধের শিরোনামগুলি টানুন।

• যেকোনো নতুন কোড ফাইলের প্রিফিক্স Apache License v2.0 এর সাথে যুক্ত থাকতে হবে:

  /**
   *   @license
   *   Copyright <Current YYYY> Google LLC
   *   SPDX-License-Identifier: Apache-2.0
   */
  

পরিবর্তন করুন এবং যাচাই করুন

1. নির্ভরতা ইনস্টল করতে blockly-samples এর রুট লেভেলে npm install চালান।
2. প্লাগইনের ডিরেক্টরিতে npm run start চালান এবং প্লাগইনের পরীক্ষা পৃষ্ঠাটি চালিত একটি সার্ভার তৈরি এবং শুরু করুন। আপনি এই পৃষ্ঠাটি ব্যবহার করে প্লাগইনের বিদ্যমান আচরণ দেখতে পারেন, অথবা যদি আপনি একটি নতুন প্লাগইন যোগ করেন তবে আপনাকে এটিকে একটি কার্যকর পরীক্ষা পৃষ্ঠা করতে হবে যাতে অন্যরা আপনার প্লাগইন কী করে তা দেখতে পারে। আরও তথ্যের জন্য খেলার মাঠের পৃষ্ঠাটি দেখুন।
3. প্লাগইনের কোডে যেকোনো প্রয়োজনীয় পরিবর্তন করুন।
4. যদি আপনি সার্ভারটি চালু রেখে যান, তাহলে আপনার পরিবর্তনগুলি স্বয়ংক্রিয়ভাবে লোড হবে। অন্যথায়, সার্ভারটি পুনরায় চালু করুন এবং প্লাগইনটি প্রত্যাশা অনুযায়ী আচরণ করছে কিনা এবং কনসোলে কোনও ত্রুটি বা সতর্কতা নেই কিনা তা যাচাই করুন।
5. npm run build চালান এবং নিশ্চিত করুন যে কোনও বিল্ড ত্রুটি নেই।
6. test/ ডিরেক্টরিতে স্বয়ংক্রিয় মোচা পরীক্ষা লিখুন।
7. স্বয়ংক্রিয় পরীক্ষা চালানোর জন্য npm run test চালান।
8. লিন্ট ত্রুটি ঠিক করতে npm run lint:fix । অবশিষ্ট যেকোনো সতর্কতা বা ত্রুটির সমাধান করুন।
9. অটোফরম্যাটার চালানোর জন্য npm run format চালান।
10. যদি সমস্ত পরীক্ষায় উত্তীর্ণ হন, তাহলে আপনি আপনার পরিবর্তনগুলি সহ প্রধানের বিরুদ্ধে একটি পিআর খুলতে প্রস্তুত।