歡迎參與 FreeBSD 文件計劃( 簡稱 FDP ) 。維持優秀質量的文件對 FreeBSD 的成功來說十分重要,您的點滴貢獻都是十分寶貴的。
本文件描述:『 FDP 的架構有哪些』、『如何撰寫並提交文件』、 『如何有效運用工具來協助撰稿』。
歡迎大家對 FDP 做出貢獻。唯一的成員要求就有貢獻的意願。
本入門書指出如何:
瞭解有哪些文件是由 FDP 所維護的。
安裝所需的文件工具和檔案
修改文件
提交修改以供審核並納入 FreeBSD 文件
FDP 負責四類 FreeBSD 文件
使用手冊: 使用手冊主要是給 FreeBSD 使用者提供詳盡的線上參考資料。
FAQ 主要是收集在各郵件論壇或論壇會常問到或有可能會問到的 FreeBSD 相關問題與答案 。 (簡單講,就是『問答集』格式) 通常會擺在這裡面的問答格式,不會放太長的詳細內容。
線上手冊 ( manual pages ):英文版的系統 manual 並不是由 FDP 所撰寫的,因為它們是屬於 base system 的部份。 然而,FDP 可以修改這些文件,來讓這些文件寫得更清楚,甚至是勘正錯誤的地方。
網站: 這是 FreeBSD 在網路上的主要部份,位於 http://www.FreeBSD.org/ 以及許多其他 mirror 站。這網站是許多人第一次接觸 FreeBSD 的地方
翻譯團隊負責翻譯使用手冊和網站到不同的語言。線上手冊目前並未翻譯
FreeBSD 網站、使用手冊、和 FAQ 的文件原始碼可以在 https://svn.FreeBSD.org/doc/
的文件庫取得。
線上手冊的原始碼則是在 https://svn.FreeBSD.org/base/
的原始碼庫可以取得。
文件提交訊息可以用 svn log
察看。 提交訊息也會保存在http://lists.FreeBSD.org/mailman/listinfo/svn-doc-all
。
這些儲存庫的網頁版位於https://svnweb.FreeBSD.org/doc/ 和 https://svnweb.FreeBSD.org/base/。
許多人會寫 FreeBSD 的教學文件或是 how-to 文章。有些保存在 FDP 的檔案中。其他一些文件則是作者希望放在他處。FDP 會盡力提供這些文件的連結。
本文及其他文件,可由此下載: ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/。
若有 FreeBSD 方面疑問,請先閱讀
FreeBSD 相關文件,如不能解決的話,再洽詢
<questions@FreeBSD.org>。
關於本文件的問題,請洽詢
<doc@FreeBSD.org>。