os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Update to talk about books and articles, rather than the FAQ, Handbook,

Browse source 
and tutorials.

Prompted by:	Bill Moran <wmoran@iowna.com>
This commit is contained in:
Nik Clayton 2001-09-08 19:33:04 +00:00
parent fc681cb9b7
commit 07af8e9d27
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/www/; revision=10628
1 changed files with 10 additions and 26 deletions
Download patch file Download diff file Expand all files Collapse all files

36
en/docproj/doc-set.sgml
View file

@ -1,6 +1,6 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN" [
<!ENTITY base CDATA "..">
<!ENTITY date "$FreeBSD: www/en/docproj/doc-set.sgml,v 1.8 2001/04/17 12:21:53 nik Exp $">
<!ENTITY date "$FreeBSD: www/en/docproj/doc-set.sgml,v 1.9 2001/07/13 12:52:13 dd Exp $">
<!ENTITY title "FreeBSD Documentation Project: Documentation Set">
<!ENTITY % includes SYSTEM "../includes.sgml"> %includes;
]>
@ -8,7 +8,7 @@
<html>
&header;
<p>FreeBSD's documentation falls into four basic categories;</p>
<p>FreeBSD's documentation falls into three basic categories;</p>
<ol>
<li><p><a href="http://www.FreeBSD.org/cgi/man.cgi"><b>The manual pages</b></a></p>
@ -24,33 +24,17 @@
FreeBSD, and most of the time the best person to write the manual
page is the person that wrote that part of FreeBSD.</p></li>
<li><p><a href="../FAQ/index.html"><b>The FAQ</b></a></p>
<li><p><a href="../docs.html#books"><b>The Books</b></a></p>
<p>This is maintained by the project. The aim is to address (in short
question and answer format) questions that are asked or should be
asked on the various mailing lists and newsgroups devoted to
FreeBSD. The format does not permit long winded and comprehensive
answers.</p></li>
<p>The project has a large amount of documentation that is "book
length", or becoming that way. These include the FreeBSD FAQ and
the FreeBSD Handbook.</p>
<li><p><a href="../handbook/index.html"><b>The Handbook</b></a></p>
<li><p><a href="../docs.html#articles"><b>The Articles</b></a></p>
<p>This is maintained by the project. Topics that need a more in depth
discussion are addressed in the Handbook.</p></li>
<li><p><a href="../tutorials/index.html"><b>The Tutorials</b></a></p>
<p>Some of these tutorials are maintained by Project committers, others
are not. The <b>maintenance</b> of these documents is up to the
individual authors, although, to the best of my knowledge,
they have all kept them up to date, solicit comments from the
readership and so on.</p>
<p>Some of the tutorials are stored on the FreeBSD web site. For these
tutorials the authors submit their changes to one of the committers,
and the committer makes the change. Other tutorials are stored on the
author's private webspace, and the author can make changes as and
when they wish. Sometimes this is a deliberate choice on the part
of the author, and sometimes it is a historical accident.</p></li>
<p>FreeBSD has a wealth of information available in shorter, article
form -- similar to the tutorials or HOWTO documentation of other
projects.</p>
</ol>