หน้านี้มีรายละเอียดของโครงการการเขียนเชิงเทคนิคที่ยอมรับสำหรับ Google Season of Docs
ข้อมูลสรุปของโปรเจ็กต์
- องค์กรโอเพนซอร์ส:
- moja ทั่วโลก
- ผู้เขียนด้านเทคนิค:
- แอนโธนี
- ชื่อโปรเจ็กต์:
- เอกสารของโค้ดเครื่องมือการรายงาน
- ระยะเวลาของโปรเจ็กต์:
- ระยะเวลามาตรฐาน (3 เดือน)
คำอธิบายโปรเจ็กต์
หลังจากมีโอกาสได้บันทึกเครื่องมือการรายงานสำหรับองค์กร Moja Global แล้ว ผมจึงเสนอให้พัฒนาเอกสารประกอบ 6 ประเภทที่กลุ่มเป้าหมายแต่ละกลุ่มจะใช้เพื่อบรรลุวัตถุประสงค์ที่แตกต่างกัน ซึ่งจะสรุปได้ดังนี้
1) คู่มือการตั้งค่าสภาพแวดล้อม
1.1) วิศวกรระบบ ผู้ชมเป้าหมาย
1.2) Objective ช่วยวิศวกรระบบในการตั้งค่าสภาพแวดล้อมการสร้างและการดําเนินการภายในสําหรับเครื่องมือการรายงาน
1.3) รูปแบบ บทความแสดงวิธีการที่กำหนดชุดขั้นตอนตามลำดับที่วิศวกรระบบต้องทำเพื่อตั้งค่าสภาพแวดล้อมที่เอื้อต่อการสร้างและเรียกใช้เครื่องมือการรายงาน
2) คู่มือการสร้าง
2.1) วิศวกรระบบ สำหรับกลุ่มเป้าหมาย
2.2) วัตถุประสงค์ในการช่วยวิศวกรระบบ ในการสร้างคอมโพเนนต์เครื่องมือการรายงานจากซอร์สโค้ด
2.3) รูปแบบ บทความแสดงวิธีการที่กำหนดชุดขั้นตอนตามลำดับที่วิศวกรระบบต้องทำเพื่อรับและคอมไพล์ซอร์สโค้ดของเครื่องมือการรายงาน
3) คู่มือการติดตั้ง
3.1) วิศวกรระบบ สำหรับกลุ่มเป้าหมาย
3.2) วัตถุประสงค์เพื่อช่วยให้วิศวกรระบบติดตั้งองค์ประกอบของเครื่องมือการรายงานที่สร้างขึ้นใหม่
3.3) รูปแบบ บทความแสดงวิธีการที่กำหนดชุดขั้นตอนตามลำดับซึ่งวิศวกรระบบต้องทำเพื่อติดตั้งใช้งานเครื่องมือการรายงานในสภาพแวดล้อมการตั้งค่าใหม่
4) คู่มือการใช้งาน
4.1) เครื่องมือรวมระบบ ผู้ชมเป้าหมาย
4.2) Objective Help วิศวกรระบบสามารถเรียกใช้อินสแตนซ์เครื่องมือการรายงานที่ติดตั้งใหม่
4.3) รูปแบบ บทความแสดงวิธีการที่กำหนดชุดขั้นตอนตามลำดับที่ผู้รวมระบบต้องทำเพื่ออัปโหลดและประมวลผลฐานข้อมูลเอาต์พุต Flux บนอินสแตนซ์เครื่องมือการรายงานที่ทำงานอยู่
คู่มือการดำเนินการ เริ่มต้นใช้งานและประมวลผลฐานข้อมูลเอาต์พุต Flux ในเครื่องมือการรายงาน
5) คู่มือผู้ใช้
5.1) ผู้ใช้ปลายทาง ของกลุ่มเป้าหมาย
5.2) วัตถุประสงค์ ช่วยให้ผู้ใช้ปลายทางเข้าใจฟีเจอร์ต่างๆ ที่ฝังอยู่ในเครื่องมือการรายงาน และวิธีที่ฟีเจอร์เหล่านี้ควรใช้
5.3) รูปแบบ บทความแสดงวิธีการที่กำหนดชุดขั้นตอนตามลำดับซึ่งผู้ใช้ปลายทางต้องทำเพื่อใช้ฟังก์ชันของเครื่องมือการรายงานอย่างเหมาะสม
6) คู่มือการพัฒนา
6.1) โปรแกรมเมอร์ สำหรับกลุ่มเป้าหมาย
6.2) วัตถุประสงค์ ช่วยให้ผู้ใช้ปลายทางเข้าใจฟีเจอร์ต่างๆ ที่ฝังอยู่ในเครื่องมือการรายงาน และวิธีที่ฟีเจอร์เหล่านี้ควรใช้
6.3) รูปแบบ บทความอ้างอิงที่อธิบาย: ก) องค์ประกอบการออกแบบที่สำคัญของเครื่องมือ ข) การแยกส่วนการทำงานขององค์ประกอบข้างต้น ค) องค์ประกอบการดำเนินการขององค์ประกอบที่แยกส่วนได้
และบทแนะนำสั้นๆ ที่อธิบายวิธีการปรับโค้ดให้เหมาะกับสถานการณ์ที่เฉพาะเจาะจงของผู้ใช้