ฉันคิดว่าหัวข้อนี้ถูกเลือกมาอย่างดี มัน "เจ๋ง" ในการเขียนบรรทัดของ Perl ที่ทำสิ่งต่าง ๆ เป็นหมื่นในคราวเดียว แต่แล้วมันก็แย่มากเมื่อคุณต้องกลับมายังมัน
ในบันทึกอื่นที่ฉลาดหรือไม่ต้องมีการบันทึกรหัส มีความต้านทานที่ไม่ตรงกันระหว่างภาษาโปรแกรมที่เป็นที่ยอมรับในอุตสาหกรรมและแนวความคิดระดับสูงที่เราในฐานะมนุษย์คุ้นเคยกับการคิดของเรา รหัสการจัดทำเอกสารด้วยตนเองไม่สามารถใช้งานได้จริงจนกระทั่งกลายเป็นภาษาธรรมชาติ ถึงแม้ว่าจะต้องมีการจัดทำเอกสารรหัส Prolog เนื่องจากอาจมีระดับสูง แต่ก็ยังค่อนข้างเป็นทางการ
โค้ดความละเอียดแบบละเอียดจะทำหน้าที่นำแผนหยาบไปใช้ซึ่งจะต้องมีการบันทึกไว้ ฉันไม่ต้องการที่จะอ่านผ่านทั้ง 50 วิธีเมื่อความคิดเห็นแผนงาน 3 บรรทัดอย่างรวดเร็วจะทำ
การแก้ไขในภายหลัง: ตัวอย่างเพิ่มเติมที่พูดเก่งกว่าคือตัวอย่างที่เหนือกว่าคอมพิวเตอร์ หนังสืออาจจะเขียนได้ดีมาก แต่เรามักต้องการดำเนินการในระดับที่แตกต่างกันของสิ่งที่เป็นนามธรรม บ่อยครั้งที่สรุปของหนังสือเล่มนี้จะทำและนั่นคือสิ่งที่ความคิดเห็นสามารถเสนอรหัส แน่นอนว่ารหัสที่เป็นนามธรรมนั้นสามารถนำไปสู่การจัดทำเอกสารด้วยตนเองได้นาน แต่ก็ไม่สามารถให้คุณได้ในระดับที่เป็นนามธรรม
และความคิดเห็นยังสามารถทำตัวเหมือนไซด์เทนในหนังสือเมื่อเราจำเป็นต้องอธิบายกระบวนการให้เหตุผลที่อยู่เบื้องหลังการอ้างสิทธิ์ในข้อความหลักโดยไม่มีการหยุดชะงัก
ด้วยบริบทนี้ฉันพบว่าคำสั่งก่อนหน้าของฉันอ้างถึงภาษาธรรมชาติที่อยู่เหนือความต้องการความคิดเห็นไม่ถูกต้อง แม้แต่ภาษาธรรมชาติเช่นในหนังสืออาจยืมเอกสารอธิบายเพื่ออธิบายสิ่งที่เป็นนามธรรมที่เป็นตัวเป็นตนในข้อความหรือให้การออกนอกเส้นทางโดยไม่ทำให้ข้อความหลักตกราง ด้วยข้อสังเกตที่ว่ารหัสที่ถูกต้องแล้วนั้นอาจจะไปไกลกว่าการเป็นเอกสารด้วยตนเอง
สุดท้าย แต่ไม่ท้ายสุดความคิดเห็นสามารถช่วยให้ coder อยู่ในระดับสูงได้ บ่อยครั้งที่ฉันทราบว่าความคิดเห็นต่อเนื่องสองรายการที่ฉันรวมไว้ในรายการขั้นตอนไม่ได้พูดในระดับเดียวกับสิ่งที่เป็นนามธรรมซึ่งรับประกันทันทีว่าเป็นสิ่งสำคัญที่ฉันกำลังทำกับรหัสนั้น
ปัญหาบางอย่างอยู่เหนือการเข้ารหัสและส่งผลกระทบต่อการเข้ารหัสเช่นเดียวกับกิจกรรมอื่น ๆ ความคิดเห็นสามารถให้ความช่วยเหลือในการชี้แจงเหตุผลเบื้องหลังและแง่มุมของรหัสของเราและฉันพบว่าพวกเขาเป็นเพื่อนที่น่าพอใจที่พูดภาษาที่นุ่มนวลเพื่อประโยชน์ของบุคคลสำหรับการเปลี่ยนแปลง