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