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