বর্তমানে আমি যে কোডবেসে কাজ করছি তা এটি হতাশ হয়ে পড়েছে; আমাদের প্রচলিত নামগুলি সংক্ষিপ্ত এবং বর্ণনাতীত। আমি এই প্রকল্পের একমাত্র বিকাশকারী, এবং তাদের বেশিরভাগ কী করবে সে সম্পর্কে কোনও ডকুমেন্টেশন নেই, সুতরাং তারা যা উপস্থাপন করে তা ট্র্যাক করার জন্য আমাকে অতিরিক্ত সময় ব্যয় করতে হবে।
উদাহরণস্বরূপ, আমি এমন কিছু কোড পড়ছিলাম যা একটি অপটিক্যাল পৃষ্ঠের সংজ্ঞা আপডেট করে। শুরুতে সেট করা পরিবর্তনশীলগুলি নিম্নরূপ ছিল:
double dR, dCV, dK, dDin, dDout, dRin, dRout
dR = Convert.ToDouble(_tblAsphere.Rows[0].ItemArray.GetValue(1));
dCV = convert.ToDouble(_tblAsphere.Rows[1].ItemArray.GetValue(1));
... and so on
সম্ভবত এটি কেবল আমিই, তবে তারা আমাকে কীভাবে উপস্থাপন করেছিল সে সম্পর্কে মূলত আমাকে কিছু বলেনি, যা কোডটি বোঝা আরও নীচে জটিল করে তুলেছিল। আমি কেবল জানতাম যে এটি একটি নির্দিষ্ট টেবিল থেকে কোথাও কোথাও একটি পরিবর্তনশীল পার্সড নির্দিষ্ট সারি। কিছু অনুসন্ধানের পরে, আমি তাদের কী বোঝাতে চেয়েছি তা জানতে পেরেছিলাম:
dR = radius
dCV = curvature
dK = conic constant
dDin = inner aperture
dDout = outer aperture
dRin = inner radius
dRout = outer radius
আমি সেখানে যা করেছি তা মূলত আমি তাদের নামকরণ করেছি। এটি কিছু লাইন লম্বা করে, তবে আমার মনে হয় এটি একটি ন্যায্য বাণিজ্য off এই ধরণের নামকরণের স্কিমটি প্রচুর কোড জুড়ে ব্যবহৃত হয়। আমি নিশ্চিত নই যে এটি এমন বিকাশকারীদের কাছ থেকে কোনও শিল্পকর্ম যা পুরানো সিস্টেমগুলির সাথে কাজ করে শিখেছিল বা এর পিছনে আরও গভীর কারণ রয়েছে কিনা। এইভাবে ভেরিয়েবলের নাম রাখার কোন যুক্তিসঙ্গত কারণ নেই, বা আমি এগুলি জুড়ে আসার সাথে সাথে আরও বর্ণনামূলক নামগুলিতে আপডেট করার পক্ষে যুক্তিযুক্ত কি?
dK = conic constant
।