สิ่งนี้กลายเป็นความสับสนอย่างใหญ่หลวงกับโค้ดเบสที่ฉันกำลังทำงานอยู่ ชื่อตัวแปรหลายชื่อของเรานั้นสั้นและไม่มีคำอธิบาย ฉันเป็นนักพัฒนาเพียงคนเดียวที่เหลืออยู่ในโครงการและไม่มีเอกสารเกี่ยวกับสิ่งที่พวกเขาส่วนใหญ่ทำดังนั้นฉันต้องใช้เวลาเพิ่มเติมเพื่อติดตามสิ่งที่พวกเขาเป็นตัวแทน
ตัวอย่างเช่นฉันอ่านโค้ดบางตัวที่อัพเดตนิยามของผิวหน้าออปติคัล ตัวแปรที่ตั้งไว้ที่จุดเริ่มต้นมีดังนี้:
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
ฉันเปลี่ยนชื่อพวกเขาเป็นสิ่งที่ฉันมี มันยาวขึ้นบางบรรทัด แต่ฉันรู้สึกว่ามันเป็นการแลกเปลี่ยนที่ยุติธรรม อย่างไรก็ตามรูปแบบการตั้งชื่อแบบนี้จะใช้กับรหัสจำนวนมากอย่างไรก็ตาม ฉันไม่แน่ใจว่ามันเป็นสิ่งประดิษฐ์จากนักพัฒนาที่เรียนรู้จากการทำงานกับระบบเก่าหรือไม่หรือมีเหตุผลที่ลึกซึ้งกว่านี้ มีเหตุผลที่ดีที่จะตั้งชื่อตัวแปรด้วยวิธีนี้หรือไม่หรือฉันเป็นธรรมในการอัปเดตให้เป็นชื่อที่อธิบายเพิ่มเติมเมื่อฉันเจอพวกเขา?
dK = conic constant
ได้รับการอนุมัติ: