หน้านี้มีรายละเอียดของโปรเจ็กต์การเขียนเชิงเทคนิคที่ได้รับการยอมรับสำหรับ Google Season of Docs
สรุปโปรเจ็กต์
- องค์กรโอเพนซอร์ส
- Qubes OS
- นักเขียนเชิงเทคนิค:
- luzeal
- ชื่อโปรเจ็กต์:
- เริ่มต้นใช้งาน QubesOS มาเขียนคู่มือที่เปิดกว้างและใช้งานง่ายกัน
- ระยะเวลาของโปรเจ็กต์
- ระยะเวลามาตรฐาน (3 เดือน)
คำอธิบายโปรเจ็กต์
เริ่มใช้งาน QubesOS
ฉันต้องการสร้างคู่มือแบบเปิดและเนื้อหาที่เกี่ยวข้องสำหรับผู้ใช้ QubesOS ครั้งแรก เป้าหมายคือเพื่อแนะนำ QubesOS ให้แก่บุคคลทั่วไป และทำให้คู่มือกระชับและเข้าใจง่ายที่สุดโดยใช้การเปรียบเทียบ ภาพประกอบ และแผนภาพ เราจะใช้ลิงก์ไปยังแหล่งข้อมูลที่เชื่อถือได้และน่าเชื่อถือ รวมถึงลิงก์ในเว็บไซต์ QubesOS เป็นหลักเพื่อให้กระชับ โดยทุกอย่างจะเผยแพร่ภายใต้ใบอนุญาตแบบเปิด
คำว่า "สแตนด์อโลน" หมายถึงเนื้อหาที่อาจอยู่นอกเว็บไซต์ได้ เช่น คู่มือ ซึ่งไม่เทียบเท่ากับคู่มือฉบับออฟไลน์ โดยหลักการแล้ว ระบบจะสร้างช่องทางอีกช่องทางหนึ่งสำหรับการเผยแพร่เนื้อหาเป็นแนวทางควบคู่ไปกับเว็บไซต์
คำว่า "เปิด" หมายถึงคู่มือที่จะเผยแพร่ภายใต้ใบอนุญาตแบบเปิด
วิธีดำเนินการ
กําหนดกลุ่มเป้าหมาย
ณ วันนี้ เรารู้สึกว่าหมวดหมู่ผู้ใช้ที่ QubesOS กําหนดเป้าหมายนั้นไม่ชัดเจน QubesOS จะช่วยนักข่าว ทนายความ นักวิเคราะห์ด้านความปลอดภัย นักพัฒนาซอฟต์แวร์ และอื่นๆ ได้อย่างไร การอธิบายสถานการณ์ที่ QubeOS มีประโยชน์จะเป็นประโยชน์
กำหนดความคาดหวังให้ถูกต้อง
นอกจากนี้ คุณควรเตือนผู้ใช้ครั้งแรกว่า QubesOS ต้องใช้ความรู้ด้านไอทีในระดับหนึ่ง การใช้งาน QubesOS มีค่าใช้จ่ายขึ้นอยู่กับความสามารถในการใช้งาน โดยเฉพาะอย่างยิ่งในกรณีที่ QubesOS เป็นระบบคอมพิวเตอร์หลักของคุณ ในทํานองเดียวกัน QubeOS ก็มีบางสิ่งที่ทําได้ไม่ดี (ตามการออกแบบ) เช่น การเร่งความเร็ว 3 มิติในเครื่องเสมือน คุณควรระบุข้อมูลนี้อย่างชัดเจนตั้งแต่ต้น ไม่ใช่เพื่อยับยั้งไม่ให้ผู้ใช้ใช้แอป แต่เพื่อกำหนดข้อยกเว้นสำหรับผู้มีโอกาสเป็นผู้ใช้
QubesOS คืออะไรและไม่ใช่อะไร
แม้ว่า QubesOS จะเป็นระบบปฏิบัติการสายพันธุ์พิเศษ (การแจกจ่าย Xen) แต่การเปรียบเทียบกับระบบปฏิบัติการอื่นๆ ตามฟังก์ชันการทำงานหรือข้อจำกัดของฟังก์ชันการทำงานก็น่าสนใจ (เช่น Windows ใช้การจำลองเสมือนและแซนด์บ็อกซ์เป็นกลไกการรักษาความปลอดภัยมากขึ้นเรื่อยๆ) คุณอาจใช้แผนภาพ/ตารางง่ายๆ ได้
เราจะกำหนดข้อกำหนดของคู่มือร่วมกับชุมชน
คู่มือควรมีข้อมูลขั้นต่ำอะไรบ้าง การติดตั้งจะลดความซับซ้อนได้มากน้อยเพียงใดโดยไม่ลดระดับความปลอดภัย เกณฑ์ควรอยู่ที่ใด มีการตั้งค่า QubesOS ที่ปลอดภัยและใช้งานได้น้อยที่สุดบ้างไหม หากไม่มี ก็สามารถกําหนดและตั้งค่าเป็นเป้าหมายสําหรับคู่มือได้
ใบอนุญาต
รับใบอนุญาต วิกิ Archlinux ที่มีชื่อเสียงใช้สัญญาอนุญาตเอกสารประกอบเสรี GNU เวอร์ชัน 1.3 ขึ้นไป ใบอนุญาตนี้เหมาะหรือไม่
กิจกรรมอื่นๆ
ทำให้เอกสารประกอบของเว็บไซต์ดูน่าสนใจยิ่งขึ้น
คุณสามารถไฮไลต์โน้ตโดยใช้สีแดงหรือสีเหลืองเพื่อให้สังเกตได้ง่ายขึ้น เช่น คุณอาจใช้กล่องสีได้ เช่น กล่องสีที่มีอยู่ในวิกิของ Archlinux https://wiki.archlinux.org/index.php/Linux_Containers
คุณใช้การอ้างอิงแบบตัดตอนได้
เนื้อหาลิงก์
ปัจจุบันเว็บไซต์เอกสารประกอบมีเนื้อหาค่อนข้างมาก แต่แต่ละส่วนมักไม่ได้ลิงก์กับหัวข้ออื่นๆ ที่เกี่ยวข้อง บทความต่างๆ สามารถลิงก์กันได้เพื่อเพิ่มการค้นพบ