আমি মনে করি বিষয়টি ভালভাবে নির্বাচিত হয়েছে। পার্লের একটি লাইন লিখতে "শীতল" যা একবারে দশ হাজার কাজ করে, তবে এটি যখন আপনাকে আবার দেখা করতে হয় তখন এটি স্তন্যপান করে।
একটি ভিন্ন নোটে, চালাক বা না, কোড অবশ্যই নথিভুক্ত করা উচিত। শিল্প-গৃহীত প্রোগ্রামিং ভাষা এবং উচ্চ স্তরের ধারণাগুলির মধ্যে একটি অন্তর্নিহিত প্রতিবন্ধকতা মেলে না যা আমরা মানুষ হিসাবে আমাদের চিন্তায় অভ্যস্ত। স্ব-ডকুমেন্টিং কোডটি কেবল উপলব্ধিযোগ্য নয় - যতক্ষণ না এটি প্রাকৃতিক ভাষা হয়, ততক্ষণ। এমনকি প্রোলোগ কোডটি নথিভুক্ত করা দরকার, তবে এটি উচ্চ স্তরের হতে পারে, এটি এখনও বরং আনুষ্ঠানিক।
সূক্ষ্ম দানযুক্ত অপরিহার্য কোডটি মোটা দানাদার পরিকল্পনাগুলি বাস্তবায়নের জন্য কাজ করে - যা নথিভুক্ত করা দরকার। একটি তাত্ক্ষণিক 3-লাইনের রোডম্যাপ মন্তব্য করবে তখন আমি পদ্ধতির 50 টি লাইনের মধ্য দিয়ে পড়তে চাই না।
পরে সম্পাদনা করুন: আরও স্পষ্ট উদাহরণ হ'ল কম্পিউটারগুলিকে ছাড়িয়ে যাওয়া। একটি বই খুব ভাল লেখা হতে পারে, তবে আমরা প্রায়শই এটি বিমূর্ততার বিভিন্ন স্তরে প্রক্রিয়া করতে চাই। প্রায়শই, বইটির একটি সংক্ষিপ্তসারটি ঘটবে এবং মন্তব্যগুলি কোডের প্রস্তাব দিতে পারে। অবশ্যই ভাল বিমূর্ত কোড স্ব ডকুমেন্টেশনের দিকে অনেক এগিয়ে যেতে পারে তবে এটি বিমূর্ততার সমস্ত স্তর আপনাকে দিতে পারে না।
এবং মন্তব্যগুলি কোনও বইয়ের সিডেনোটসের মতো কাজ করতে পারে, যখন আমাদের মূল পাঠ্যের দাবিটি পিছনে না ফেলেই পিছনে যুক্তি প্রক্রিয়াটি ব্যাখ্যা করা দরকার।
এই প্রসঙ্গে, আমি দেখতে পেলাম যে প্রাকৃতিক ভাষায় মন্তব্যগুলির প্রয়োজনকে অতিক্রম করে আমার পূর্বের বক্তব্যটি ভুল। এমনকি কোনও গ্রন্থের মতো প্রাকৃতিক ভাষাও ডকুমেন্টেশনের কাছে theণ দিতে পারে, পাঠ্যটিতে বিমূর্ত বিমূর্ত বর্ণনাকে বিচ্ছিন্নভাবে ব্যাখ্যা করতে বা মূল পাঠ্যকে অবরুদ্ধ না করে পথ প্রদত্ত করতে পারে। নোট সহ যে ভাল বিমূর্ত কোড ইতিমধ্যে স্ব ডকুমেন্টিং হওয়ার দিকে অনেক এগিয়ে গেছে।
সর্বশেষে, তবে কম নয়, মন্তব্য কোডারকে বিমূর্ততার উচ্চ স্তরে রাখতে সহায়তা করতে পারে। প্রায়শই আমি বুঝতে পারি যে ধারাবাহিকভাবে দুটি মন্তব্য আমি পদক্ষেপের তালিকায় অন্তর্ভুক্ত করেছি বিমূর্ততার একই স্তরে কথা বলি না, যা অবিলম্বে আমি এই কোডটি দিয়ে কী করছি তার একটি সমালোচনামূলক নজরদারি দেয়।
কিছু সমস্যা কোডিংকে ছাড়িয়ে যায় এবং অন্যান্য ক্রিয়াকলাপের মতো কোডিংকেও প্রভাবিত করে। মন্তব্যগুলি আমাদের কোডের পিছনে যুক্তি এবং দিকগুলি পরিষ্কার করতে সহায়তা করতে পারে এবং আমি তাদের একটি আনন্দদায়ক সঙ্গী পাই যা একজন ব্যক্তির পরিবর্তনের জন্য উপকারের জন্য একটি নরম ভাষায় কথা বলে।