本頁針對 Google 系列文件接受的技術撰寫專案提供詳細資料。
專案摘要
- 開放原始碼機構：
- FreeBSD 專案
- 技術文件撰寫者：
- Quaffeine
- 專案名稱：
- 製作 Wine 手冊章節
- 專案長度：
- 標準長度 (3 個月)
Project description
在這個計畫中，我將針對 FreeBSD 手冊中參閱 WINE (www.winehq.org) 的安裝、使用方式及疑難排解等事宜深入介紹此計畫。除非另有註明，否則我希望每週投入 4 到 8 小時處理下列項目。
*** 社群債券
如果獲選，我會花費「社群綁約」期間，自行熟悉 FreeBSD 專案的說明文件和基礎架構。專案刊登的一致文件內容讓人印象深刻，而且我也會和專案團隊成員分享他們的工作流程。我也會加入並瀏覽使用者導向的論壇，瞭解 FreeBSD 使用者對一般說明文件可以提供哪些協助，並特別協助 WINE 開發 FreeBSD。
我會在這段期間花一些時間學習專案的說明文件工具鍊。這麼一來，我就能在專案初期的早期階段就順利抵達目的地。
*** 第 1 週 (9/14 至 19)：測試安裝與疑難排解
我會在文件開發階段的第一週，用 FreeBSD 目前的穩定版執行 WINE 的模擬測試，以及安裝與執行各種 Windows 應用程式，包括簡易公用程式和較複雜的應用程式。這是我在 ReactOS for MakeUseOf (https://www.makeuseof.com/tag/reactos-open-source-windows-clone/) 上所採取的類似文章中採用的做法，只有本週的時間能用來檢查更廣泛的程式選項。
根據我的經驗，預先花時間處理這類問題，有助於找出一般「gotcha」問題 (及進行疑難排解)。這樣我就能在實際時間撰寫相關版面，或至少獲得人力請求協助。
週目標：概略說明安裝章節，並提供修正常見安裝問題的必要詳細資訊。
*** 第 2 週 (9/21-25)：記錄 WINE 安裝
在第 2 週期間，我確實會透過熱門的方法草擬說明 WINE 的安裝方式，包括：
- 使用通訊埠系統從來源
- 透過使用核心存放區的二進位套件；
- 使用可用的 GUI 套件管理工具 (如果有的話)，以及
- 從替代存放區，例如 FreshPorts (以及使用者打算這麼做的原因)。
本節重點是探討 32 位元與 64 位元並同時安裝的情況，強調執行不同架構程式需要的額外步驟。
週目標：本節的完善草稿版本，說明在 FreeBSD 上安裝 WINE。「經過修改的草稿」應納入幾乎最終文字 (待校對和評論意見回饋)，以及螢幕截圖的預留位置 (而非螢幕截圖本身)。
*** 第 3 週 (9/28-10/2)：以 FreeBSD 執行您的第一個 WINE 計畫
安裝 WINE 子系統後，下一節將詳細說明某些初始程式的安裝與執行作業。這些公用程式最有可能聚焦於簡單的獨立公用程式，例如開放原始碼 Notepad++。目標是讓使用者快速下載應用程式、安裝應用程式，直到執行最省事。
本節必須向使用者說明，部分/許多 Windows 應用程式可以確實在 FreeBSD 上執行，因此成為日常運算的絕佳選擇。
週目標：發現少數可以正常安裝且 (大部分) 可立即安裝的程式，以及經過改良的草稿版本說明安裝項目。
*** 第 4 週 (10/5-9)：WINE 總覽與概念
在上一節的結尾，您需特別微調和自訂，讓特定應用程式能夠順利執行 WINE，屆時 WINE 子系統的簡介有助於提供背景資訊。這些章節將詳細說明 WINE 系統的內容、它與 FreeBSD 的互動方式，以及使用者可在哪裡開始進一步瞭解系統或排解問題。
請特別注意，這個部分不會複製現有資源，而是提供井然有序的總覽，並連結至其他 (方便消化) 來源取得更多資訊。
週目標：關於向使用者介紹 WINE 子系統的各節內容，內容經過改良的草稿版本。
*** 第 5 週 (10/12-16)：FreeBSD 的 WINE 設定
這些章節將深入探討 WINE 的實際設定，從 FreeBSD 的整體修改/調整開始。也會說明如何使用 $WINEPREFIX 資料夾來自訂特定應用程式的 WINE 環境。由於目前已有資源可深入說明這個概念，因此在建立連結之前，本章節只會顯示適切的介紹。
週目標：本節的完善草稿，詳述需要在哪些情況下設定 WINE 的深度、位置和情境。
*** 第 6 週 (10/19-23)：針對 FreeBSD 使用 WINE GUI
設定 WINE 以執行特定程式是相當複雜且耗時的運動，因此我們有輔助工具讓此程序變得更容易。本節將概略說明 FreeBSD 中部分選項的安裝及使用方法，包括：
- 勝利
- 葡萄酒莊
- Playonbsd
- 另外提供的
週目標：提供精緻的草擬章節，說明如何安裝及使用最熱門的 GUI WINE 輔助應用程式。
*** 第 7 週 (10/26-30)：WINE/FreeBSD 常見問題 (研究)
有關 WINE 等複雜技術應用的複雜資訊，可以顯示在使用者嘗試解決特定問題，以及由專家提供解答的情形下。這樣就能在在同一處收集部分常見問題 (尤其是已知會影響 FreeBSD 使用者的常見問題)，節省大量使用者的時間。
這些章節就是為了達成這個目標，本週我將花很多時間研究 FreeBSD 使用者經常與 WINE 解決的問題類型，並盡可能縮小搜尋範圍並盡可能測試答案。這麼做可讓閱讀手冊的讀者更快解決特定問題。
本節也會列出相關資源，讓您瞭解應在哪些地方尋求解答。
週目標：包含 FreeBSD 使用者或一般使用者最常遇到的 WINE 問題草稿，以及與解決方案相關的連結/附註。請注意，雖然本週的工作沒有任何輸出內容，但可能需要投入更多時間才能尋找及解決常見問題，以及追蹤解決方案。我應該在進行研究後大約 8 到 10 個小時，
*** 第 8 週 (11/2-6)：WINE/FreeBSD 常見問題
本週我們要花時間統整第 7 週的研究，針對常見問題/常見疑難排解問題建立章節 (視情況提供解決方法的連結)。
週目標：精心編排的版面內容，列出常見問題/常見問題，以及解決問題的逐步說明。
*** 第 9 週 (11/9-13)：多位使用者 WINE 管理
如果管理員想在多使用者環境中部署 WINE，可參閱本節提供的指引。這不只包含在多個使用者之間共用子系統本身的最佳做法，也包括部署在 WINE 中的 Windows 應用程式。
週目標：精心撰寫的草稿章節，詳細說明 FreeBSD 管理員如何部署 WINE 和 WINE 型應用程式。
*** 第 10 週 (11/16-20)：附錄、評論意見與管理問答
雖然我希望能在草擬過程中參考其他指導員和其他審查者的意見回饋，但在這週中還有時間進行更廣泛的重新組織/重寫作業。
此外，我會在這段期間內撰寫本手冊章節 (前線、索引等) 所需的一切管理員知識，以及整合與 WINE 相關的後續閱讀內容 (例如透過二進位檔相容性使用 Linux 版本的 WINE、舊遊戲/程式的 DOSBox 等)。
週目標：整份手冊章節的精緻草稿，包括所有其他章節。
*** 第 11 週 (11/23-27)：手冊章節結案
我會安排這一週到上週的課程，以便校對所有文字、檢查圖片，並視需要測試各種輸出內容 (HTML、PDF 等)。如果在初次編寫上述軟體 (從 FreeBSD 本身到 WINE 或其輔助人員) 的時間內進行升級，本週也同樣能夠提供更新功能。
週目標：手冊章節最終版本，包含所有必要更新。
*** 第 12 週 (11/30-12/5)：專案完成
與專案導師達成協議後，我會確認《手冊》章節的內容成為原始碼控管系統、彙整專案報告，並將專案提交完成。