Documentation that seems clear and

Documentation that seems clear and adequate to its authors is often about as clear as mud to the programmer who must maintain the code 6 months or 6 years later. Even when the information is present, the maintenance programmer doesn’t know where to look for it. It is almost as common to find that the same topic is covered twice, but that the statements in the documentation are inconsistent with each other and the code

ผลลัพธ์ (ไทย) 1:

เอกสารที่ชัดเจน และเพียงพอกับผู้เขียนเป็นมักจะเกี่ยวกับล้างโคลนให้โปรแกรมเมอร์ที่ต้องรักษารหัส 6 เดือนหรือ 6 ปีเป็นการ เมื่อข้อมูลเป็นปัจจุบัน โปรแกรมเมอร์บำรุงรักษาไม่ทราบว่าจะค้นหามัน เกือบเป็นทั่วไปพบว่า หัวข้อเดียวกันครอบคลุมสอง แต่คำในเอกสารที่สอดคล้องกับแต่ละอื่น ๆ และรหัส

ผลลัพธ์ (ไทย) 2:

เอกสารที่ดูเหมือนว่าชัดเจนและเพียงพอที่จะผู้เขียนมักจะเกี่ยวกับการเป็นที่ชัดเจนเป็นโคลนโปรแกรมเมอร์ที่จะต้องรักษารหัส 6 เดือนหรือ 6 ปีต่อมา แม้เมื่อข้อมูลที่เป็นปัจจุบันโปรแกรมการบำรุงรักษาที่ไม่รู้จักที่จะมองหามัน มันเกือบจะเป็นเรื่องปกติท​​ี่จะพบว่าหัวข้อเดียวกันถูกปกคลุมสองครั้ง แต่ว่างบในเอกสารไม่สอดคล้องกับแต่ละอื่น ๆ และรหัส

ผลลัพธ์ (ไทย) 3:

เอกสารที่ชัดเจนและเพียงพอของผู้เขียนมักจะเกี่ยวกับใสเหมือนโคลนสำหรับโปรแกรมเมอร์ที่ต้องเก็บรักษารหัส 6 เดือนหรือ 6 ปีต่อมา แม้ว่าข้อมูลที่เป็นปัจจุบัน การบํารุงรักษาโปรแกรม ไม่รู้จะไปหาที่ไหนเลย มันเกือบจะเป็นโดยทั่วไปพบว่า หัวข้อเดียวกันครอบคลุมถึงสองครั้งแต่ ว่าข้อความในเอกสารที่สอดคล้องกับแต่ละอื่น ๆและรหัส