章 1. 概論

內容目錄
1.1. FreeBSD 文件的組成部分
1.2. 在開工之前...
1.3. 快速上手篇

歡迎參與 FreeBSD 文件計劃。維持優秀質量的文件對 FreeBSD 的成功來說十分重要, 而 FreeBSD 文件計劃(以下皆以 FDP 來代表 FreeBSD Documentation Project 的縮寫) 則與這些文件撰寫、更新息息相關,因此您的點滴貢獻都是十分寶貴的。

本文件最主要的目的,就是清楚告訴您:『FDP 的架構有哪些』、『如何撰寫並提交文件給 FDP』、 『如何有效運用工具來協助撰稿』。

我們歡迎每個熱心的志士來加入 FDP 行列。FDP 並不限定每月必須交出多少稿量,才能加入。 您唯一須要作的就是訂閱 FreeBSD documentation project 郵遞論壇

讀完本份文件,您將會:

1.1. FreeBSD 文件的組成部分

FDP 總共負責 FreeBSD 的 4 種類別的文件:

線上手冊(manual)

英文版的系統 manual 並不是由 FDP 所撰寫的,因為它們是屬於 base system 的部份。 然而,FDP 可以(也曾這麼做過)修改這些文件,來讓這些文件寫得更清楚,甚至是勘正錯誤的地方。

翻譯團隊負責將系統的線上手冊翻譯為不同的語言。 這些譯本都由 FDP 維護。

FAQ

FAQ 主要是收集在各論壇或 newsgroup 會常問到或有可能會問到的 FreeBSD 相關問題與答案 。 (簡單講,就是『問答集』格式) 通常會擺在這裡面的問答格式,不會放太長的詳細內容。

使用手冊(Handbook)

使用手冊主要是給 FreeBSD 使用者提供詳盡的線上參考資料。

Web site

FreeBSD 主要各項介紹方面的 WWW 部份,歡迎逛逛 http://www.FreeBSD.org/ 以及許多其他 mirror 站。這網站是許多人第一次接觸 FreeBSD 的地方。

這四個文件組成部分都可透過 FreeBSD CVS tree 來取得。也就是說,這些文件的修改記錄對於任何人都是公開的, 而且無論是誰都可以用像是 CSup, CVSupCTM 將文件取出來(checkout)並放在自己機器上做備份或副本參考等用途。

此外,許多人會寫些教學文件或維護有關 FreeBSD 內容的網站。(若作者同意的話)其中有些資料會保存在 FreeBSD 正式 CVS repository 內。而其他的文件,可能作者不希望被放在 FreeBSD repository 內而另存他處。 總之,FDP 會盡力提供這些文件的連結。

本文及其他文件,可由此下載:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/

若有 FreeBSD 方面疑問,請先閱讀 FreeBSD 相關文件,如不能解決的話,再洽詢 <questions@FreeBSD.org>。
關於本文件的問題,請洽詢 <doc@FreeBSD.org>。