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