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