欢迎参与 FreeBSD 文档计划。 维持高品质的文档对 FreeBSD 的成功来说至关重要, 而 FreeBSD 文档计划 (以下皆以 FDP 来代表 FreeBSD Documentation Project 的缩写) 则与这些文档的撰写、 更新息息相关,因此您的点滴贡献都是十分宝贵的。
这份文档最主要的目的,就是清楚告诉您:『FDP 的架构有哪些』、『如何撰写并提交文档给 FDP』、 『如何有效运用工具来协助撰稿』。
我们欢迎每个热心的志士来加入 FDP 行列。FDP 并不限定每月必须交出多少稿量,才能加入。 您唯一须要作的就是订阅 FreeBSD 文档计划邮件列表 。
读完本份文档, 您将:
了解有哪些文档是由 FDP 所维护的。
可以看懂 FDP 所维护的 SGML 源文件。
了解如何来对这些文件作修改。
了解如何投稿自己的修改部份, 并最后正式成为 FreeBSD 文档的一部分。
FDP 总共负责 FreeBSD 的 4 种类别的文档:
英文版的系统联机手册并不是由 FDP 所撰写的, 因为它们是基本系统的组成部份。 然而, FDP 可以 (也曾) 修改这些文档, 来让这些文档写得更清楚, 甚至是勘正错误的地方。
翻译团队负责将系统的联机手册翻译为不同的语言。 这些译本将在 FDP 中维护。
FAQ 主要是收集在各论坛或 newsgroup 会常问到或有可能会问到的 FreeBSD 相关问题与答案。 (简单讲,就是『问答集』格式) 通常会摆在这里面的问答格式, 不会放太长的详细内容。
手册主要的目标是为 FreeBSD 用户提供详尽的联机参考资料。
FreeBSD 主要各项介绍方面的 WWW 部份, 欢迎逛逛 http://www.FreeBSD.org/ 以及许多其它 mirror 站。 这网站是许多人第一次接触 FreeBSD 的地方。
文档中的这四个组成部分都通过 FreeBSD CVS 来提供。 这意味着这些文件的修改记录对于任何人都是可见的, 并且, 任何人都可以通过类似 CVSup 或 CTM 这样的程序来在本地保存文档的副本。
此外, 许多人会撰写教程或维护其他关于 FreeBSD 的网站。 这些资料有些也会保存在 CVS 文档库中 (如果作者同意的话)。 其他情况下, 文档的作者可能希望在 FreeBSD 主文档库以外的地方来保存他们的文档。 FDP 努力提供尽可能多的此类文档的链接。
本文档和其它文档可从这里下载:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.
如果对于FreeBSD有问题,请先阅读文档,如不能解决再联系<questions@FreeBSD.org>.
关于本文档的问题请发信联系 <doc@FreeBSD.org>.