A árvore doc/ é organizada
de uma forma particular, e os documentos que compõe o
Primer do Projeto de Documentação do FreeBSD devem ser por isso organizados de forma
particular. O objetivo é tornar simples a
adição de nova documentação à
árvore, e:
Facilitar a automatização da conversão de documentos para outros formatos.
Promover consistência entre diferentes formas de organizar a documentação, facilitar a troca entre diferentes documentos.
Facilitar a decisão de onde na árvore uma nova documentação deveria ser colocada.
Além disso, a árvore de documentação tem de acomodar documentação que pode estar em muitas diferentes línguas e muitas diferentes codificações. É importante que a estrutura da árvore de documentação não force nenhum padrão particular ou preferência cultural.
Existem dois tipos de diretórios sob
doc/, cada um com nomes de
diretórios e significados muito específicos.
share/share/mk, enquanto os arquivos
adicionais para suporte SGML (como as extensões do
FreeBSD ao DocBook DTD) encontram-se em
share/xml.idioma.codificação/en_US.ISO8859-1/ e
zh_TW.Big5/. Os nomes são
longos, mas ao especificar completamente a língua e
codificação prevenimos qualquer futura dor de
cabeça caso um time de tradução queira
prover a documentação na mesma língua
mas em mais de uma codificação. Isto
também nos isola completamente de quaisquer
problemas que possam ser causados por uma mudança
para Unicode.Este, e outros documentos, podem ser obtidos em ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/
Para perguntas sobre FreeBSD, leia a
documentação antes de contatar
<questions@FreeBSD.org>.
Para perguntas sobre esta documentação, envie e-mail para
<doc@FreeBSD.org>.