โครงการ FreeBSD

หน้านี้มีรายละเอียดของโปรเจ็กต์การเขียนเชิงเทคนิคที่ได้รับการยอมรับสำหรับ 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): สรุปโปรเจ็กต์

ตามที่ได้ตกลงกับที่ปรึกษาของโปรเจ็กต์ เราจะตรวจสอบบทในคู่มือในระบบควบคุมแหล่งที่มา รวบรวมรายงานโปรเจ็กต์ และส่งโปรเจ็กต์ให้เสร็จสมบูรณ์