cfd9e12239
- Move includes.nav*.sgml to share/sgml/navibar.ent and
<lang>/share/sgml/nabibar.l10n.ent.
- Move includes.sgml and includes.xsl to
share/sgml/common.ent, share/sgml/header.ent, <lang>/share/sgml/l10n.ent,
and <lang>?share/sgml/header.l10n.ent.
- Move most of XSLT libraries to share/sgml/*.xsl and
<lang>/share/sgml/*.xsl.
- Move news.xml and other *.xml files for the similar purpose
to share/sgml/*.xml and <lang>/share/sgml/*.xml.
- Switch to use a custom DTD for HTML document. Now we use
"-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension", which is
HTML 4.01 + some entities previously pulled via
"<!ENTITY % includes SYSTEM "includes.sgml"> %includes;" line.
The location of entity file will be resolved by using catalog file.
- Add DOCTYPE declearation to XML documents. This makes the followings
possible:
* Use of &foo; entities for SGML in an XML file instead of defining
{$foo} as the same content.
* &symbolic; entities for Latin characters.
- Duplicated information between SGML and XML, or English and
translated doc, has been removed as much as possible.
82 lines
2.9 KiB
Text
82 lines
2.9 KiB
Text
<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
|
|
<!ENTITY base CDATA "..">
|
|
<!ENTITY date "$FreeBSD: www/en/docproj/docproj.sgml,v 1.20 2005/10/04 17:14:02 blackend Exp $">
|
|
<!ENTITY title "FreeBSD Documentation Project">
|
|
<!ENTITY % navinclude.docs "INCLUDE">
|
|
]>
|
|
<!-- $FreeBSD: www/en/docproj/docproj.sgml,v 1.20 2005/10/04 17:14:02 blackend Exp $ -->
|
|
|
|
<html>
|
|
&header;
|
|
|
|
<h2>Overview</h2>
|
|
|
|
<p>Getting to grips with a new and complex operating system is always a
|
|
difficult task, no matter how pretty the GUI is. FreeBSD is no different
|
|
in this respect.</p>
|
|
|
|
<p>While there are a vast number of BSD Unix (and general &unix;) books
|
|
available, FreeBSD has its own unique features, procedures and
|
|
quirks.</p>
|
|
|
|
<p>In addition, FreeBSD will be the first exposure to a Unix-like
|
|
operating system for many of its users, so the availability of high
|
|
quality, accurate documentation is paramount.</p>
|
|
|
|
<p>The FreeBSD Documentation Project exists to help fill this gap. There
|
|
are two ways in which this is undertaken:</p>
|
|
|
|
<ol>
|
|
<li><p>Members of the Documentation Project write documentation and
|
|
submit it for inclusion in the <em>FreeBSD Documentation
|
|
Set</em>.</p></li>
|
|
|
|
<li><p>Members of the Documentation Project discuss and arrange the
|
|
formatting and organization of the <em>FreeBSD Documentation
|
|
Set</em>.</p></li>
|
|
</ol>
|
|
|
|
<table class="tblbasic">
|
|
<tbody>
|
|
<tr>
|
|
<td><h2 align="center"><a href="current.html">Current
|
|
projects</a></h2>
|
|
|
|
<p>There are a number of projects currently <em>in progress</em> as
|
|
part of the documentation effort. Please take the time to look over
|
|
this list and see if there is anything <b>you</b> can help
|
|
with.</p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<h2><a href="who.html">Who we are, how to join</a></h2>
|
|
|
|
<p>This page explains who makes up the Documentation Project, and how
|
|
you can join.</p>
|
|
|
|
<h2><a href="doc-set.html">The FreeBSD Documentation Set</a></h2>
|
|
|
|
<p>This page outlines the components of the FreeBSD Documentation Set, and
|
|
the sort of work that the Documentation Project does with them.</p>
|
|
|
|
<h2><a href="sgml.html">SGML and the Documentation Project</a></h2>
|
|
|
|
<p>The project uses SGML for the documentation. This page
|
|
outlines how this is accomplished, and directs the interested reader to
|
|
further SGML resources.</p>
|
|
|
|
<h2><a href="submitting.html">Submitting Documentation</a></h2>
|
|
|
|
<p>Submitting documentation is the best way to become a part of the
|
|
project, and help make FreeBSD easier to use. This page explains the
|
|
best way to submit documentation so that it gets looked at as soon as
|
|
possible.</p>
|
|
|
|
<h2><a href="translations.html">Translation</a></h2>
|
|
<p>Translations of the FreeBSD documentation, Web pages,
|
|
Handbook, Manual pages and FAQ.</p>
|
|
|
|
&footer;
|
|
</body>
|
|
</html>
|