When documentation is written, it i

When documentation is written, it is usually poorly organized, incomplete and imprecise. Often the coverage is random; a programmer or manager decides that a particular idea is clever and writes a memo about it while other topics, equally important, are ignored. In other situations, where documentation is a contractual requirement, a technical writer, who does not understand the system, is hired to write the documentation. The resulting documentation is ignored by the maintenance programmers because it is not accurate. Some projects keep two sets of books; there is the official documentation, written as required for the contract, and the real documentation, written informally when specific issues arise.

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

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

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

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

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

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