หน้านี้มีรายละเอียดของโปรเจ็กต์การเขียนเชิงเทคนิคที่ได้รับการยอมรับสำหรับ Google Season of Docs
สรุปโปรเจ็กต์
- องค์กรโอเพนซอร์ส:
- The FreeBSD Project
- นักเขียนเชิงเทคนิค
- ควอฟฟีน
- ชื่อโปรเจ็กต์:
- สร้างบทในคู่มือไวน์
- ความยาวของโปรเจ็กต์:
- ระยะเวลามาตรฐาน (3 เดือน)
คำอธิบายโปรเจ็กต์
ในโครงการริเริ่มนี้ เราจะจัดทำบทซึ่งมีข้อมูลโดยละเอียดของคู่มือ FreeBSD เกี่ยวกับการติดตั้ง การใช้งาน และการแก้ปัญหา WINE (www.winehq.org) ใน FreeBSD ฉันตั้งใจจะใช้เวลา 4-8 ชั่วโมงในแต่ละสัปดาห์เพื่อทำงานเกี่ยวกับรายการด้านล่าง เว้นแต่จะระบุไว้เป็นอย่างอื่น
*** การเชื่อมโยงชุมชน
หากได้รับเลือก ฉันจะใช้เวลาช่วงผูกพันกับชุมชนเพื่อทำความคุ้นเคยกับกระบวนการและโครงสร้างพื้นฐานของเอกสารประกอบของโปรเจ็กต์ FreeBSD เราประทับใจเอกสารประกอบที่โปรเจ็กต์นี้จัดทำขึ้นเสมอ และอยากมีส่วนร่วมกับสมาชิกในทีมเกี่ยวกับเวิร์กโฟลว์ของโปรเจ็กต์ นอกจากนี้ ฉันจะเข้าร่วมและเรียกดูฟอรัมที่มุ่งเน้นผู้ใช้เพื่อทำความเข้าใจว่าสิ่งใดที่เป็นประโยชน์สำหรับผู้ใช้ FreeBSD ในเรื่องเกี่ยวกับเอกสารโดยทั่วไป และช่วยในการทำงานร่วมกับ WINE บน FreeBSD โดยเฉพาะ
เราจะใช้เวลาในช่วงนี้เพื่อเรียนรู้เครื่องมือทางเทคนิคของเอกสารประกอบของโปรเจ็กต์ ซึ่งจะทำให้ฉันทำงานได้อย่างมีประสิทธิภาพในช่วงต้นสัปดาห์ของโครงการหากได้รับเลือก
*** สัปดาห์ที่ 1 (14-9/19): การติดตั้งทดสอบและการแก้ปัญหา
ฉันใช้เวลาช่วงสัปดาห์แรกของระยะการพัฒนาเอกสารในการทดสอบการติดตั้ง WINE ในเวอร์ชันเสถียรปัจจุบันของ FreeBSD รวมถึงการติดตั้งและเรียกใช้แอปพลิเคชัน Windows ต่างๆ ตั้งแต่ยูทิลิตีง่ายๆ ไปจนถึงแอปพลิเคชันที่ซับซ้อนมากขึ้น นี่เป็นแนวทางที่เราใช้ในบทความที่คล้ายกันเกี่ยวกับ ReactOS สำหรับ MakeUseOf (https://www.makeuseof.com/tag/reactos-open-source-windows-clone/) เพียงแต่เราจะใช้เวลาในช่วงสัปดาห์แรกเพื่อตรวจสอบโปรแกรมที่หลากหลายมากขึ้น
จากประสบการณ์ของเรา การใช้เวลาในช่วงต้นเช่นนี้มีประโยชน์ในการระบุ (และแก้ปัญหา) ปัญหาทั่วไปประเภท "ติดกับดัก" วิธีนี้จะช่วยให้เราเตรียมวิธีแก้ปัญหาไว้ได้เมื่อถึงเวลาเขียนส่วนที่เกี่ยวข้องจริงๆ หรืออย่างน้อยต้องมีคำขอความช่วยเหลือไปยังช่องทางที่เหมาะสม
เป้าหมายประจำสัปดาห์: เพื่อใส่โครงร่างของบทการติดตั้งและรายละเอียดที่จำเป็นเกี่ยวกับวิธีแก้ไขปัญหาการติดตั้งที่พบได้ทั่วไป
*** สัปดาห์ที่ 2 (21-25 กันยายน): บันทึกการติดตั้ง WINE
ในช่วงสัปดาห์ที่ 2 เราจะร่างส่วนต่างๆ ที่แสดงการติดตั้ง WINE ผ่านวิธีการยอดนิยม ซึ่งรวมถึง
- จากแหล่งที่มาโดยใช้ระบบพอร์ต
- ผ่านแพ็กเกจไบนารีโดยใช้ที่เก็บข้อมูลหลัก
- ใช้ตัวจัดการแพ็กเกจ GUI ที่มีอยู่ (หากมี) และ
- จากที่เก็บสำรอง เช่น FreshPorts (และเหตุผลที่ผู้ใช้ควรทำเช่นนั้น)
ส่วนสําคัญของส่วนนี้คือ การพูดคุยเกี่ยวกับการติดตั้งแบบ 32 บิตกับ 64 บิตและการติดตั้งพร้อมกัน เพื่อเน้นขั้นตอนเพิ่มเติมที่ต้องใช้เมื่อเรียกใช้โปรแกรมสถาปัตยกรรมที่แตกต่างกัน
เป้าหมายของสัปดาห์: ร่างที่ขัดเกลาแล้วของส่วนอธิบายการติดตั้ง WINE ใน FreeBSD "ฉบับร่างที่ขัดเกลาแล้ว" นี้ควรมีข้อความเกือบเสร็จสมบูรณ์ (รอการพิสูจน์อักษรและรับความคิดเห็นจากการตรวจสอบ) รวมถึงตัวยึดตําแหน่งสําหรับภาพหน้าจอ หากไม่ใช่ภาพหน้าจอเอง
*** สัปดาห์ที่ 3 (28/9-2/10): การเรียกใช้โปรแกรม WINE รายการแรกใน FreeBSD
เมื่อติดตั้งระบบย่อย WINE แล้ว ส่วนถัดไปจะแสดงรายละเอียดการติดตั้งและการดำเนินการของโปรแกรมเริ่มต้นบางรายการ วิดีโอเหล่านี้มีแนวโน้มที่จะมุ่งเน้นที่ยูทิลิตีแบบสแตนด์อโลนและใช้งานง่าย เช่น Notepad++ แบบโอเพนซอร์ส โดยมีเป้าหมายเพื่อให้ผู้ใช้ดาวน์โหลดแอปพลิเคชัน ติดตั้ง และใช้งานแอปพลิเคชันได้อย่างง่ายดาย
ส่วนนี้สำคัญในการแสดงให้เห็นให้ผู้ใช้เห็นว่าแอปพลิเคชัน Windows บาง/หลายรายการทำงานบน FreeBSD ได้จริง จึงถือเป็นตัวเลือกที่ใช้งานได้จริงสำหรับการใช้งานในชีวิตประจำวัน
เป้าหมายของสัปดาห์: ระบุโปรแกรมจำนวนไม่มากนักที่ติดตั้งได้อย่างราบรื่นและใช้งานได้ทันที (ส่วนใหญ่) รวมถึงร่างเวอร์ชันที่ขัดเกลาแล้วของส่วนต่างๆ ที่แสดงการติดตั้ง
*** สัปดาห์ที่ 4 (5-9 ต.ค.): ภาพรวมและแนวคิดของ WINE
ส่วนท้ายของส่วนก่อนหน้านี้จะกล่าวถึงความจำเป็นในการปรับแต่งและปรับเปลี่ยนบางอย่างเพื่อให้แอปพลิเคชันบางรายการทำงานใน WINE ได้ ซึ่งในตอนนี้ ข้อมูลเบื้องต้นเกี่ยวกับระบบย่อย WINE จะเป็นประโยชน์ในการให้บริบท ส่วนเหล่านี้จะตรวจสอบสิ่งที่มาพร้อมกับระบบ WINE วิธีที่ระบบโต้ตอบกับ FreeBSD และจุดที่ผู้ใช้สามารถเริ่มทำความเข้าใจระบบเพิ่มเติมหรือแก้ปัญหาได้
โปรดทราบว่าส่วนนี้ไม่ได้มีจุดประสงค์เพื่อทําซ้ำทรัพยากรที่มีอยู่ แต่เพื่อนำเสนอภาพรวมที่ชัดเจนซึ่งลิงก์ไปยังแหล่งข้อมูลอื่นๆ (เข้าใจง่าย) เพื่อดูข้อมูลเพิ่มเติม
เป้าหมายประจำสัปดาห์: ฉบับร่างที่สมบูรณ์ของส่วนซึ่งแนะนำระบบย่อย WINE ให้แก่ผู้ใช้
*** สัปดาห์ที่ 5 (12-16 ต.ค.): การกําหนดค่า WINE ใน FreeBSD
ส่วนเหล่านี้จะเจาะลึกการกําหนดค่าจริงของ WINE โดยเริ่มจากการปรับแต่ง/การปรับค่าโดยรวมสําหรับ FreeBSD โดยเฉพาะ รวมถึงจะแสดงการใช้โฟลเดอร์ $WINEPREFIX ซึ่งสามารถใช้ปรับแต่งสภาพแวดล้อม WINE สําหรับแอปพลิเคชันหนึ่งๆ ได้ เนื่องจากมีแหล่งข้อมูลที่มีอยู่ซึ่งอธิบายแนวคิดนี้อย่างละเอียด ส่วนนี้จะให้ข้อมูลเบื้องต้นอย่างละเอียดพอสมควรก่อนที่จะลิงก์ไปยังแหล่งข้อมูลเหล่านั้น
เป้าหมายประจำสัปดาห์: ฉบับร่างที่สมบูรณ์ของส่วนที่แสดงรายละเอียดสถานที่ วิธีการ และภายใต้สถานการณ์ที่ต้องกำหนดค่า WINE โดยละเอียด
*** สัปดาห์ที่ 6 (19-23 ต.ค.): GUI ของ WINE ใน FreeBSD
สำหรับขอบเขตที่ว่าการตั้งค่า WINE เพื่อเรียกใช้โปรแกรมหนึ่งๆ อาจเป็นแบบฝึกหัดที่ซับซ้อนและใช้เวลานาน มีเครื่องมือผู้ช่วยที่จะช่วยให้กระบวนการนี้ง่ายขึ้น ส่วนนี้จะให้ภาพรวมเกี่ยวกับการติดตั้งและการใช้ตัวเลือกบางอย่างที่มีอยู่ใน FreeBSD ซึ่งรวมถึง
- WINECfg
- winetricks
- playonbsd
- อื่นๆ ตามที่มีอยู่
เป้าหมายของสัปดาห์: จัดทำส่วนฉบับร่างที่ขัดเกลาแล้วพร้อมวิธีการติดตั้งและใช้แอปพลิเคชันตัวช่วย GUI ของ WINE ที่ได้รับความนิยมสูงสุดให้ได้มากที่สุด
*** สัปดาห์ที่ 7 (26-30 ต.ค.): คําถามที่พบบ่อยเกี่ยวกับ WINE/FreeBSD (การวิจัย)
ข้อมูลที่มีคุณค่าที่สุดบางส่วนเกี่ยวกับแอปพลิเคชันทางเทคนิคที่ซับซ้อน เช่น WINE จะพบได้จากการโต้ตอบระหว่างผู้ใช้ที่พยายามแก้ปัญหาหนึ่งๆ กับผู้เชี่ยวชาญที่เป็นผู้ให้คำตอบ เครื่องมือนี้ช่วยประหยัดเวลาให้กับผู้ใช้ได้เป็นอย่างมาก หากรวบรวมคำถามที่พบบ่อยบางข้อเหล่านี้ โดยเฉพาะอย่างยิ่งคำถามที่ทราบแล้วว่าผู้ใช้ FreeBSD มารวมไว้ในที่เดียว
ส่วนเหล่านี้มีจุดประสงค์เพื่อดำเนินการดังกล่าว และเราจะใช้เวลาทั้งสัปดาห์นี้ในการค้นคว้าประเภทปัญหาที่ผู้ใช้ FreeBSD มักพบเกี่ยวกับ WINE รวมถึงค้นหาและทดสอบคำตอบ (เท่าที่จะทำได้) วิธีนี้จะช่วยให้ผู้อ่านบทในคู่มือนี้มีโอกาสแก้ปัญหาหนึ่งๆ ได้อย่างรวดเร็วมากขึ้น
ส่วนนี้จะมีรายการแหล่งข้อมูลสำหรับค้นหาคำตอบที่ส่วนนี้ไม่มีให้ด้วย
เป้าหมายของสัปดาห์: ขัดเกลาส่วนฉบับร่างที่มีปัญหา WINE ที่พบบ่อยที่สุด ซึ่งผู้ใช้ FreeBSD หรือผู้ใช้ทั่วไปพบเจอ และลิงก์/หมายเหตุเกี่ยวกับวิธีแก้ปัญหา โปรดทราบว่าแม้ว่างานของสัปดาห์นี้จะไม่มีเอาต์พุตฉบับร่าง แต่อาจต้องใช้เวลามากขึ้นในการค้นหาและแก้ไขปัญหาที่พบได้ทั่วไป รวมถึงติดตามหาวิธีแก้ปัญหา เราคาดว่าจะใช้เวลาประมาณ 8-10 ชั่วโมงในการวิจัยนี้
*** สัปดาห์ที่ 8 (2-6 พ.ย.): คำถามที่พบบ่อยเกี่ยวกับ WINE/FreeBSD
สัปดาห์นี้เราจะใช้เวลาในการสังเคราะห์การวิจัยของสัปดาห์ที่ 7 เพื่อสร้างส่วนคำถามที่พบบ่อย/ปัญหาการแก้ปัญหาทั่วไป (ลิงก์ไปยังโซลูชันตามความเหมาะสม)
เป้าหมายของสัปดาห์: ร่างที่ขัดเกลาแล้วของส่วนที่มีคำถามที่พบบ่อย/ปัญหาที่พบบ่อย และวิธีการแก้ปัญหาทีละขั้นตอน
*** สัปดาห์ที่ 9 (9-13 พ.ย.): การดูแลระบบ WINE แบบผู้ใช้หลายคน
ส่วนนี้จะให้คำแนะนำแก่ผู้ดูแลระบบที่ต้องการติดตั้งใช้งาน WINE ในสถานการณ์ที่มีผู้ใช้หลายคน ซึ่งไม่เพียงรวมถึงแนวทางปฏิบัติแนะนำในการแชร์ระบบย่อยกับผู้ใช้หลายคนเท่านั้น แต่ยังรวมถึงแอปพลิเคชัน Windows ที่ติดตั้งใช้งานภายใน WINE ด้วย
เป้าหมายประจำสัปดาห์: ส่วนฉบับร่างที่สมบูรณ์ซึ่งมีรายละเอียดคำแนะนำและแนวทางปฏิบัติแนะนำสำหรับผู้ดูแลระบบ FreeBSD เพื่อทำให้แอปพลิเคชันที่ใช้ WINE และ WINE ใช้งานได้สำหรับผู้ใช้หลายคน
*** สัปดาห์ที่ 10 (16-20 พ.ย.): ภาคผนวก ตรวจสอบความคิดเห็น และเรื่องการบริหาร
แม้ว่าเราจะพยายามใช้ความคิดเห็นที่ได้รับจากพี่เลี้ยงและผู้ตรวจสอบคนอื่นๆ ตลอดกระบวนการร่าง แต่สัปดาห์นี้จะเป็นโอกาสให้จัดระเบียบ/เขียนใหม่อย่างละเอียดยิ่งขึ้น หากจำเป็น
นอกจากนี้ ฉันจะเขียนผู้ดูแลระบบที่จำเป็นสำหรับบทคู่มือนี้ (หัวข้อด้านหน้า ดัชนี ฯลฯ) ระหว่างนี้ รวมถึงรวบรวมการอ่านเพิ่มเติมที่เกี่ยวข้องกับ WINE (เช่น การใช้ WINE เวอร์ชัน Linux ผ่านความเข้ากันได้กับไบนารี DOSBox สำหรับเกม/โปรแกรมเก่า เป็นต้น)
เป้าหมายของสัปดาห์: ฉบับร่างที่ขัดเกลาแล้วของบทในคู่มือทั้งบท ซึ่งรวมถึงส่วนอื่นๆ ทั้งหมด
*** สัปดาห์ที่ 11 (23-11-27): การสรุปบทในคู่มือ
ผมวางแผนที่จะทำวันที่ 2 ถึงสัปดาห์ที่แล้วเพื่อพิสูจน์อักษรทั้งหมด ตรวจสอบรูปภาพ และทดสอบเอาต์พุตต่างๆ (HTML, PDF ฯลฯ) ตามความจำเป็น สัปดาห์นี้จะมีการอัปเดตในกรณีที่ซอฟต์แวร์ข้างต้น (ตั้งแต่ FreeBSD ไปจนถึง WINE หรือเครื่องมือช่วยเหลือ) มีการอัปเกรดนับตั้งแต่มีการเขียนบทความนี้ครั้งแรก
เป้าหมายของสัปดาห์: บทในคู่มือเวอร์ชันสุดท้าย ซึ่งรวมการอัปเดตที่จำเป็นทั้งหมด
*** สัปดาห์ที่ 12 (30/11-5/12): สรุปโปรเจ็กต์
ตามที่ได้ตกลงกับที่ปรึกษาของโปรเจ็กต์ เราจะตรวจสอบบทในคู่มือในระบบควบคุมแหล่งที่มา รวบรวมรายงานโปรเจ็กต์ และส่งโปรเจ็กต์ให้เสร็จสมบูรณ์