หน้านี้มีรายละเอียดของโครงการการเขียนเชิงเทคนิคที่ยอมรับสำหรับ Google Season of Docs
ข้อมูลสรุปของโปรเจ็กต์
- องค์กรโอเพนซอร์ส:
- โครงการ FreeBSD
- ผู้เขียนด้านเทคนิค:
- ควอฟฟีน
- ชื่อโปรเจ็กต์:
- สร้างบทคู่มือไวน์
- ระยะเวลาของโปรเจ็กต์:
- ระยะเวลามาตรฐาน (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/9/25): การบันทึกการติดตั้งไวน์
ระหว่างสัปดาห์ที่ 2 ผมจะร่างส่วนที่แสดงให้เห็นการติดตั้ง WINE ตามวิธีที่นิยมใช้กัน ดังนี้
- จากแหล่งที่มาโดยใช้ระบบพอร์ต
- ผ่านแพ็กเกจไบนารีโดยใช้ที่เก็บหลัก
- การใช้เครื่องมือจัดการแพ็กเกจ GUI ที่ใช้ได้ (หากมี) และ
- จากที่เก็บสำรอง เช่น FreshPorts (และเหตุผลที่ผู้ใช้ต้องการทำเช่นนั้น)
สิ่งสำคัญในส่วนนี้คือการพูดคุยเรื่องการติดตั้งแบบ 32 บิตกับ 64 บิตและพร้อมกัน เพื่อไฮไลต์ขั้นตอนเพิ่มเติมในการใช้งานโปรแกรมของสถาปัตยกรรมต่างๆ ที่จำเป็นต้องใช้
เป้าหมายประจำสัปดาห์: เวอร์ชันแบบร่างของส่วนที่อธิบายการติดตั้ง WINE ใน FreeBSD "ฉบับร่างที่ผ่านการปรับปรุง" นี้ควรมีข้อความที่เกือบสุดท้าย (รอการพิสูจน์อักษรและตรวจสอบความคิดเห็น) และตัวยึดตำแหน่งของภาพหน้าจอหากไม่ใช่ภาพหน้าจอ
*** สัปดาห์ที่ 3 (28-10/9/2021): จัดโปรแกรม WINE โปรแกรมแรกบน FreeBSD
เมื่อติดตั้งระบบย่อย WINE แล้ว ส่วนถัดไปจะอธิบายรายละเอียดการติดตั้งและการดำเนินการของโปรแกรมเริ่มต้นบางโปรแกรม ซึ่งมักมุ่งเน้นยูทิลิตีแบบสแตนด์อโลนและเรียบง่าย เช่น Notepad++ ซึ่งเป็นโอเพนซอร์ส โดยมีเป้าหมายที่จะช่วยให้ผู้ใช้ดาวน์โหลดแอปพลิเคชัน ติดตั้ง และดูการทำงานได้ง่ายๆ โดยไม่ยุ่งยาก
ส่วนนี้มีความสำคัญต่อการแสดงให้ผู้ใช้เห็นว่าแอปพลิเคชันของ Windows บางตัว/จำนวนมากสามารถทำงานบน FreeBSD ได้จริง ทำให้ตัวเลือกนี้เป็นทางเลือกที่มีประโยชน์สำหรับการประมวลผลในชีวิตประจำวัน
เป้าหมายประจำสัปดาห์: การระบุโปรแกรมจำนวนไม่มากที่มีการติดตั้งแบบเรียบร้อยดีและ (ส่วนใหญ่) ทำงานทันทีแกะกล่อง และเวอร์ชันฉบับร่างที่ดูดีของส่วนที่แสดงการติดตั้ง
*** สัปดาห์ที่ 4 (5-9/10): ภาพรวมและแนวคิดของ WINE
ช่วงท้ายของส่วนก่อนหน้านี้จะแสดงให้เห็นถึงความจำเป็นในการปรับแต่งและการปรับแต่งเพื่อให้แอปพลิเคชันบางอย่างทำงานกับ WINE ซึ่งในจุดนี้ ข้อมูลเบื้องต้นเกี่ยวกับระบบย่อย WINE จะเป็นประโยชน์ในการให้บริบท ส่วนเหล่านี้จะตรวจสอบสิ่งที่มาพร้อมกับระบบ WINE วิธีที่ระบบดังกล่าวโต้ตอบกับ FreeBSD รวมถึงจุดที่ผู้ใช้จะเริ่มทำความเข้าใจระบบเพิ่มเติมหรือแก้ปัญหา
โปรดทราบว่าส่วนนี้ไม่ได้มุ่งทำซ้ำแหล่งข้อมูลที่มีอยู่ แต่จะแสดงภาพรวมที่เป็นระบบซึ่งลิงก์ไปยังแหล่งข้อมูลอื่นๆ (เข้าใจได้ง่าย) สำหรับข้อมูลเพิ่มเติม
เป้าหมายประจำสัปดาห์: ฉบับร่างที่ปรับแต่งส่วนที่แนะนำระบบย่อย WINE ให้กับผู้ใช้
*** สัปดาห์ที่ 5 (10/10-16): การกำหนดค่า WINE ใน FreeBSD
ส่วนเหล่านี้จะเจาะลึกไปที่การกำหนดค่าจริงของ WINE โดยเริ่มจากการแก้ไข/การปรับแต่งโดยรวมเฉพาะสำหรับ FreeBSD นอกจากนี้ยังจะแสดงให้เห็นการใช้โฟลเดอร์ $WINEPREFIX ซึ่งใช้ในการกำหนดค่าสภาพแวดล้อม WINE สำหรับแอปพลิเคชันเฉพาะ เนื่องจากมีแหล่งข้อมูลที่อธิบายแนวคิดนี้อย่างละเอียดอยู่ ในส่วนนี้จึงเป็นเพียงบทนำแบบละเอียดพอสมควรก่อนที่จะลิงก์ไปยังส่วนนั้นๆ
เป้าหมายของสัปดาห์: ฉบับร่างที่สมบูรณ์ของส่วนต่างๆ ที่ให้รายละเอียดสถานที่ วิธีการ และภายใต้สถานการณ์ที่ต้องกำหนดค่า WINE แบบเจาะลึก
*** สัปดาห์ที่ 6 (19/10-23): WINE GUIs ใน FreeBSD
การตั้งค่า WINE ให้ใช้งานโปรแกรมดังกล่าวอาจเป็นแบบฝึกหัดที่ซับซ้อนและใช้เวลานาน จึงมีเครื่องมือช่วยเหลือที่จะช่วยให้ขั้นตอนนี้ง่ายขึ้น ส่วนนี้จะกล่าวถึงภาพรวมของการติดตั้งและการใช้งานบางตัวเลือกที่มีใน FreeBSD ซึ่งได้แก่
- WINECfg
- ทัวร์ชิมไวน์
- Playonbsd
- อื่นๆ ว่าว่าง
เป้าหมายประจำสัปดาห์: เพื่อจัดเตรียมส่วนฉบับร่างที่เรียบร้อยพร้อมวิธีการติดตั้งและใช้แอปพลิเคชันตัวช่วย GUI WINE ที่ได้รับความนิยมสูงสุดเท่าที่จะเป็นไปได้
*** สัปดาห์ที่ 7 (26-30/10): คำถามที่พบบ่อยเกี่ยวกับ WINE/FreeBSD (การวิจัย)
ข้อมูลที่มีประโยชน์ที่สุดบางอย่างเกี่ยวกับแอปพลิเคชันทางเทคนิคที่ซับซ้อน เช่น WINE พบได้จากการโต้ตอบระหว่างผู้ใช้ที่พยายามแก้ไขปัญหาบางอย่างและผู้เชี่ยวชาญที่ให้คำตอบ ซึ่งจะช่วยผู้ใช้ประหยัดเวลาได้มากหากมีการรวบรวมคำถามที่พบบ่อยเหล่านี้ โดยเฉพาะคำถามที่จะมีผลต่อผู้ใช้ FreeBSD ไว้ในที่เดียว
หัวข้อเหล่านี้จะมีเป้าหมายเพื่อบรรลุเป้าหมายดังกล่าว และสัปดาห์นี้เราจะใช้เวลาศึกษาเกี่ยวกับประเภทของปัญหาที่ผู้ใช้ FreeBSD มักจะพบเกี่ยวกับ WINE ตลอดจนค้นหา และทดสอบคำตอบ (ในขอบเขตที่เป็นไปได้) ซึ่งจะช่วยให้ผู้อ่านบทในคู่มือนี้มีโอกาสมากขึ้นในการแก้ปัญหาบางอย่างได้อย่างรวดเร็ว
และในส่วนนี้ยังมีรายการแหล่งข้อมูลเกี่ยวกับตำแหน่งในการค้นหาคำตอบที่ไม่ได้ให้ไว้อีกด้วย
เป้าหมายประจำสัปดาห์: ส่วนฉบับร่างที่ผ่านการปรับปรุงซึ่งเกี่ยวกับปัญหา WINE ที่พบบ่อย ไม่ว่าจะพบโดยผู้ใช้ FreeBSD หรือปัญหาทั่วไป และลิงก์/หมายเหตุเกี่ยวกับการแก้ไขปัญหา โปรดทราบว่าแม้ว่างานในสัปดาห์นี้จะไม่มีข้อมูลฉบับร่าง แต่อาจต้องใช้เวลานานขึ้นเพื่อค้นหาและปรับแก้ปัญหาที่พบได้ทั่วไป รวมทั้งติดตามวิธีแก้ไขปัญหาเหล่านั้น เราคาดว่าจะใช้เวลาอีกประมาณ 8-10 ชั่วโมงในการวิจัยนี้
*** สัปดาห์ที่ 8 (2-6/11): คำถามที่พบบ่อยเกี่ยวกับ WINE/FreeBSD
สัปดาห์นี้เราจะใช้เวลาในการสังเคราะห์การวิจัยในสัปดาห์ที่ 7 เพื่อสร้างส่วนสำหรับคำถามที่พบบ่อย/ปัญหาทั่วไปในการแก้ปัญหา (ลิงก์ไปยังวิธีแก้ปัญหาตามความเหมาะสม)
เป้าหมายประจำสัปดาห์: แบบร่างส่วนที่แสดงคำถามที่พบบ่อย/ปัญหาที่พบบ่อย พร้อมคำแนะนำทีละขั้นตอนในการแก้ไข
*** สัปดาห์ที่ 9 (9/11/13): การดูแลระบบ WINE สำหรับผู้ใช้หลายคน
ส่วนนี้จะให้คำแนะนำแก่ผู้ดูแลระบบที่ต้องการทำให้ WINE ใช้งานได้ในสถานการณ์ที่มีผู้ใช้หลายคน ซึ่งไม่เพียงแนวทางปฏิบัติแนะนำในการแชร์ระบบย่อยกับผู้ใช้หลายคนเท่านั้น แต่ยังรวมถึงแอปพลิเคชัน Windows ที่ใช้งานภายใน WINE ด้วย
เป้าหมายประจำสัปดาห์: ส่วนฉบับร่างที่ผ่านการขัดเกลาอย่างละเอียด ซึ่งมีรายละเอียดคำแนะนำและแนวทางปฏิบัติแนะนำสำหรับผู้ดูแลระบบ FreeBSD ในการทำให้แอปพลิเคชันที่ใช้ไวน์และ WINE ใช้งานได้สำหรับผู้ใช้หลายคน
*** สัปดาห์ที่ 10 (11/11-20): ภาคผนวก ตรวจสอบความคิดเห็น และการดูแลระบบ
แม้ว่าเราจะพยายามนำความคิดเห็นที่ได้รับจาก Mentor และผู้ตรวจสอบคนอื่นๆ มาใช้ในขั้นตอนการร่างภาพ แต่สัปดาห์นี้เราจะเผื่อเวลาสำหรับการจัดระเบียบ/เขียนใหม่เพิ่มเติมหากจำเป็น
นอกจากนี้ เราจะเขียนข้อมูลการดูแลระบบที่จำเป็นสำหรับบทในคู่มือนี้ (หน้า ดัชนี ฯลฯ) ในช่วงเวลานี้ รวมถึงรวบรวมค่าเพิ่มเติมที่เกี่ยวข้องกับ WINE ด้วย (เช่น การใช้ WINE เวอร์ชันสำหรับ Linux ผ่านความเข้ากันได้กับไบนารี, DOSBox สำหรับเกม/โปรแกรมเก่าๆ เป็นต้น)
เป้าหมายประจำสัปดาห์: ฉบับร่างที่สมบูรณ์ของคู่มือทั้งบท ซึ่งรวมส่วนอื่นๆ ทั้งหมดด้วย
*** สัปดาห์ที่ 11 (23-27/11/27): การสรุปส่วนเนื้อหาในคู่มือ
ผมวางแผนที่จะใช้เวลาในช่วง 2-3 สัปดาห์ที่ผ่านมานี้เพื่อตรวจสอบข้อความทั้งหมด ตรวจสอบรูปภาพ และทดสอบผลลัพธ์ต่างๆ (HTML, PDF เป็นต้น) ตามที่จำเป็น สัปดาห์นี้ยังสามารถอัปเดตได้ในกรณีที่ซอฟต์แวร์ใดๆ ข้างต้น (จาก FreeBSD เองไปจนถึง WINE หรือผู้ช่วย) อัปเกรดภายในเวลาตั้งแต่เริ่มเขียนครั้งแรก
เป้าหมายประจำสัปดาห์: บทในคู่มือเวอร์ชันสุดท้ายของคู่มือ ซึ่งรวมการอัปเดตที่จำเป็นทั้งหมด
*** สัปดาห์ที่ 12 (30/11-12/5): สรุปผลโครงการ
ตามข้อตกลงกับที่ปรึกษาโปรเจ็กต์แล้ว ฉันจะตรวจสอบบทคู่มือเป็นการควบคุมแหล่งที่มา รวบรวมรายงานโปรเจ็กต์ และส่งโปรเจ็กต์เมื่อเสร็จสมบูรณ์