প্রতিটি অনুশীলনীর সাথে অ্যাপ্রোচ যুক্ত থাকতে পারে, যেখানে অনুশীলনীটি সমাধান করার বিভিন্ন উপায় বর্ণনা করা হয়।
অ্যাপ্রোচ
একটি অ্যাপ্রোচে দেখা উচিত কীভাবে একটি অনুশীলনী নির্দিষ্ট একটি উপায়ে সমাধান করা যায়।
- এর বিষয়বস্তু হয়:
- একটি ইডিওমেটিক অ্যাপ্রোচ নিয়ে আলোচনা করবে
- একটি নন-ইডিওমেটিক, তবে আকর্ষণীয় অ্যাপ্রোচ নিয়ে আলোচনা করবে
- একটি (সম্পূর্ণ) কোড স্যাম্পল দিয়ে শুরু করুন
- ডকুমেন্টের বাকি অংশে নিশ্চিন্তে কোড স্যাম্পল ব্যবহার করুন
- বিষয়টির গভীরে যেতে দ্বিধা করবেন না
- কাজে লাগবে এমন রিসোর্সের লিংক দিন (যেমন ডকুমেন্টেশন)
- স্নিপেটে অ্যাপ্রোচের মূল অংশটি তুলে ধরা উচিত
- সর্বোচ্চ ৮ লাইন ব্যবহার করা যাবে
আপনি যদি বিভিন্ন অ্যাপ্রোচ তুলনা করতে চান, তাহলে একটি আর্টিকেল লিখুন।
অ্যাপ্রোচের সংক্ষিপ্ত বিবরণ
- সমস্যাটির প্রেক্ষাপট তুলে ধরুন
-
সব অ্যাপ্রোচের ক্ষেত্রে প্রযোজ্য গুরুত্বপূর্ণ বিষয়গুলো (যেমন বিপদগুলো) বর্ণনা করুন
- সবচেয়ে ইডিওমেটিক অ্যাপ্রোচগুলো নিয়ে আলোচনা করুন
- প্রতিটি অ্যাপ্রোচ শুরু হওয়া উচিত অ্যাপ্রোচটি তুলে ধরা একটি স্নিপেট দিয়ে
- বিষয়বস্তু বেশ উচ্চপর্যায়ে রাখুন
- বিস্তারিত তথ্য থাকা উচিত আলাদা একটি অ্যাপ্রোচ পেজে
- আরও তথ্যের জন্য সেই আলাদা অ্যাপ্রোচ পেজে লিংক দিন
- অ্যাপ্রোচগুলোর মধ্যে থেকে কীভাবে বেছে নিতে হয় তা নিয়ে আলোচনা করুন
- কোনটির কী সুবিধা-অসুবিধা?
- কিছু অ্যাপ্রোচ কি নির্দিষ্ট ব্যবহারের ক্ষেত্রে বেশি মানানসই?
সাধারণ বিবেচনা
- কিছু ভাষায় একই জিনিস লেখার ভিন্ন ভিন্ন উপায় থাকে। ওই সিনট্যাক্সের কোনোটি যদি ভাষার সাম্প্রতিক ভার্সনগুলোতেই কেবল পাওয়া যায়, তাহলে "পুরোনো" সিনট্যাক্স ব্যবহার করার কথা ভাবুন। এতে শিক্ষার্থীদের কোডটি বোঝার সম্ভাবনা বেড়ে যায়।
- বিকল্প সিনট্যাক্স অ্যাপ্রোচ ডকুমেন্টে দেখানো যেতে পারে
- আপনার ভাষার জন্য যদি কোনো সুপারিশকৃত স্টাইল গাইড থাকে, তাহলে (যেখানে সম্ভব) সেই নির্দেশিকা অনুসরণ করুন
কোন অনুশীলনীর জন্য অ্যাপ্রোচ লিখবেন?
সাধারণভাবে, প্র্যাকটিস অনুশীলনীগুলোর জন্যই অ্যাপ্রোচ লেখা বেশি উপযুক্ত, কারণ এগুলো সাধারণত একাধিক উপায়ে সমাধান করা যায়।
কনসেপ্ট অনুশীলনীগুলোর ক্ষেত্রে এক্সেম্পলার অ্যাপ্রোচ নিয়ে আলোচনা করা আকর্ষণীয় হতে পারে। উদাহরণস্বরূপ, যে কনসেপ্টটি শেখানো হচ্ছে সেটি কীভাবে নির্দিষ্ট কিছু কোড লিখতে সহজ করে তোলে, তা দেখাতে পারেন।
ফাইল
প্রতিটি অ্যাপ্রোচে নিচের দুটি ফাইল যোগ করতে হবে:
-
.approaches/<approach-slug>/content.md: অ্যাপ্রোচের বর্ণনা (দেখুন ডকুমেন্টেশন)
-
.approaches/<approach-slug>/snippet.txt: অ্যাপ্রোচটি তুলে ধরা স্নিপেট (দেখুন ডকুমেন্টেশন)
এরপর যোগ করতে বা হালনাগাদ করতে হবে:
-
.approaches/config.json: অ্যাপ্রোচগুলোর মেটাডেটা (দেখুন ডকুমেন্টেশন)
স্নিপেট এক্সটেনশন কনফিগার করা
আপনার ট্র্যাকের config.json ফাইলে approaches.snippet_extension ফিল্ডটি সেট করে ডিফল্ট .txt এক্সটেনশনের বদলে কাস্টম এক্সটেনশনও ব্যবহার করতে পারেন।
সেট করা থাকলে, যে স্নিপেট ফাইলটি যোগ করতে হবে তার নাম হতে হবে .approaches/<approach-slug>/snippet.<approaches.snippet_extension>.