কোর অবদান

ব্লকলি কোর রিপোজিটরিতে এমন কোড থাকে যা ব্লকলি-ভিত্তিক অ্যাপ্লিকেশন চালানোর জন্য প্রয়োজন।

জানতে হবে

এখানে ব্লকলি কোর সম্পর্কে তথ্যগুলির একটি দ্রুত ওভারভিউ রয়েছে যা আপনাকে একটি পিআর তৈরি করতে জানতে হবে।

  • কর্মরত শাখা বিকাশ করা হয় এবং বিকাশের বিরুদ্ধে সমস্ত PRs করা উচিত।
  • আপনাকে অনুরোধ করা তথ্য দিয়ে পুল অনুরোধ টেমপ্লেটটি পূরণ করতে হবে।
  • কোড অবশ্যই Google-এর টাইপস্ক্রিপ্ট স্টাইল গাইডের সাথে সঙ্গতিপূর্ণ হবে।
  • আপনার প্রতিশ্রুতি বার্তাগুলিতে প্রচলিত প্রতিশ্রুতি ব্যবহার করুন এবং অনুরোধের শিরোনাম টানুন।
  • ব্যবহারকারী-দৃশ্যমান স্ট্রিংগুলি অবশ্যই /msg/messages.js ফাইলে থাকতে হবে যাতে সেগুলি অনুবাদ করা যায়। বিশ্বের 6% এরও কম স্থানীয়ভাবে ইংরেজিতে কথা বলে।
  • ব্লকের টেক্সট সাধারণত সব ছোট হাতের হওয়া উচিত (যেমন বেশিরভাগ প্রোগ্রামিং ভাষার কীওয়ার্ড)।
  • পিছনের সামঞ্জস্য বজায় রাখুন। সেখানে প্রচুর ব্লকলি অ্যাপ রয়েছে, অন্য সবাইকে ভাঙবেন না।
  • যেকোন নতুন কোড ফাইলের সাথে Apache License v2.0 এর উপসর্গ থাকতে হবে:

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

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

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