#use wml::debian::template title="Documentação"
#use wml::debian::translation-check translation="1.61" translation_maintainer="Gustavo Noronha"

<p>Uma parte importante de um sistema operacional é a documentação, os
manuais técnicos que descrevem o uso e funcionamento dos programas. 
Como parte de seus esforços para criar um sistema operacional livre
de alta qualidade, o Projeto Debian está se esforçando para fornecer
a todos os seus usuários documentação apropriada em uma forma facilmente
acessível.</p>

<p>Se você é <em>novato</em> no Debian, nós recomendamos que comece lendo
as <a href="$(HOME)/releases/stable/releasenotes">Notas de Lançamento</a>,
o <a href="$(HOME)/releases/stable/installmanual">Guia de Instalação</a>
e o <a href="manuals/debian-faq/">FAQ do Debian GNU/Linux</a> antes
de fazer sua primeira instalação do Debian, esses documentos contêm respostas
para várias perguntas e irão ajudá-los a trabalhar com seu novo sistema Debian.
Após a instalação, talvez você queira dar uma olhada na
<a href="manuals/reference/">Referência Debian</a> e em outros
<a href="user-manuals">manuais</a>.
Outra boa fonte de informação para novos usuários é o
<a href="http://wiki.debian.org/">Debian Wiki</a>.

<p>Se você quer começar a desenvolver pacotes para o Debian, nós
recomendamos que dê uma olhada no <a href="manuals/maint-guide/">Guia dos
Novos Mantenedores Debian</a> e, em seguida, na
<a href="manuals/developers-reference">Referência do Desenvolvedor Debian</a>.
Depois você pode ler outros <a href="devel-manuals">manuais para desenvolvedores</a>.

<p>A maior parte da documentação incluída no Debian foi escrita para o
GNU/Linux em geral. Há também alguma documentação escrita especificamente
para o Debian. Esses documentos vêm nas categorias básicas abaixo:

<ul>
  <li><a href="#manuals">manuais</a>
  <li><a href="#howtos">HOWTOs</a>
  <li><a href="#faqs">FAQs</a>
  <li><a href="#other">outros documentos mais curtos</a>
</ul>


<H2><a name="manuals">Manuais</a></H2>

<p>Os manuais lembram livros porque eles descrevem tópicos importantes
compreensivelmente.

<h3>Manuais específicos do Debian</h3>

<table><tr valign=top>
  <td width="50%">

    <p><strong><font size="+1">M</font>anuais do usuário</strong>
    <br>
    <ul>
      <li><a href="user-manuals#faq">FAQ do Debian GNU/Linux</a>
      <li><a href="user-manuals#install-sarge">Guia de Instalação Debian</a>
      <li><a href="user-manuals#relnotes">Notas de Lançamento do Debian</a>
      <li><a href="user-manuals#quick-reference">Referência Debian</a>
      <li><a href="user-manuals#apt-howto">Como Usar o APT</a>
      <li><a href="user-manuals#dselect">Documentação do dselect para Iniciantes</a>
      <li><a href="user-manuals#users-guide">Guia do Usuário (da Progeny)</a> 
      <li><a href="user-manuals#usersguide">Guia do Usuário Debian Linux</a>
      <li><a href="user-manuals#euro-support">Suporte ao Euro no Debian GNU/Linux</a>
      <li><a href="user-manuals#java-faq">FAQ do Debian GNU/Linux e Java</a>
      <li><a href="user-manuals#securing">Manual de Segurança Debian</a>
      <li><a href="user-manuals#linuxcookbook">O Livro de Receitas do Linux (The Linux Cookbook)</a>

    </ul>

  </td>

  <td width="50%">

    <p><strong><font size="+1">M</font>anuais do desenvolvedor</strong>
    <br>
    <ul>
      <li><a href="devel-manuals#policy">Manual de Políticas Debian</a>
      <li><a href="devel-manuals#devref">Referência do Desenvolvedor Debian</a>
      <li><a href="devel-manuals#maint-guide">Guia dos Novos Mantenedores Debian</a>
      <li><a href="devel-manuals#dpkgint">Manual Interno do dpkg</a>
      <li><a href="devel-manuals#menu">Sistema de Menu Debian</a>
      <li><a href="devel-manuals#i18n">Introdução à i18n</a>
    </ul>

    <p><strong><font size="+1">M</font>anuais diversos</strong>
    <br>
    <ul>
      <li><a href="misc-manuals#history">História do Projeto Debian</a>
      <li><a href="misc-manuals#linuxmag">Revistas Linux</a>
      <li><a href="misc-manuals#markup">Manual de Debiandoc-SGML</a>
      <li><a href="misc-manuals#sgml-howto">HOWTO do Debian SGML/XML</a>
    </ul>

  </td>
</tr></table>

<p>A lista completa de manuais do Debian e outros documentos pode ser
encontrada nas páginas do <a href="ddp">Projeto de Documentação Debian</a>.

<p>Há também vários manuais escritos para o Debian GNU/Linux orientados para
os usuários, disponíveis como <a href="books">livros impressos</a>.

<p>Na seção de Documentação da <a href="http://debian-br.alioth.debian.org/">página
do Debian-BR</a> há vários documentos que podem ajudar os novatos a se habituarem
com o novo sistema. Entre eles estão o 
<a href="http://debian-br.alioth.debian.org/view.php?doc=pratico">Guia Prático para
o Debian GNU/Linux</a> e o 
<a href="http://debian-br.alioth.debian.org/view.php?doc=apt-howto-pt_BR">Como Usar
o APT</a>.

<h3>Manuais para o GNU/Linux em geral</h3>

<p>Alguns dos documentos e manuais mais populares do GNU/Linux são
<a href="http://www.tldp.org/LDP/gs/gs.html">Linux Installation and
Getting Started</a>, 
<a href="http://www.ibiblio.org/pub/Linux/docs/linux-doc-project/users-guide/">
Linux User's Guide</a>, 
<a href="http://www.tldp.org/LDP/nag/nag.html">Network Administrator's
Guide</a>, 
<a href="http://www.tldp.org/LDP/sag/">System Administrator's
Guide</a>, e outros.

<P>A documentação do GNU/Linux é coordenada pelos esforços do
<a href="http://www.tldp.org/">Linux Documentation Project</a> (LDP).
Você pode encontrar o conjunto completo de manuais LDP
<a href="http://www.tldp.org/guides.html">na página web deles</a>, 
além de muitos outros documentos, tanto em forma eletrônica quanto
impressa.


<H2><a name="howtos">HOWTOs</a></H2>

<p>Os <a href="http://www.tldp.org/docs.html#howto">documentos HOWTO</a>,
como diz o nome deles, descreve <em>como fazer</em> alguma coisa,
e eles normalmente cobrem um assunto mais específico.

<p>Alguns dos HOWTOS mais importantes do GNU/Linux:

<ul>
  <li><a href="http://www.tldp.org/HOWTO/Hardware-HOWTO/">Hardware
      Compatibility HOWTO</a>,
  <li><a href="http://www.tldp.org/HOWTO/Unix-and-Internet-Fundamentals-HOWTO/">
      Unix and Internet Fundamentals HOWTO</a>,
# currently not available
#  <li><a href="http://www.tldp.org/HOWTO/Kernel-HOWTO.html">Kernel
#      HOWTO</a>,
  <li><a href="http://www.tldp.org/HOWTO/Filesystems-HOWTO.html">Filesystems
      HOWTO</a>,
  <li><a href="http://www.tldp.org/HOWTO/Config-HOWTO/">Configuration
      HOWTO</a>,
  <li><a href="http://www.tldp.org/HOWTO/Net-HOWTO/">Networking
      HOWTO</a>,
  <li>and <a href="http://www.tldp.org/HOWTO/HOWTO-INDEX/categories.html">
      many others</a>.
</ul>

<p>Eles estão também disponíveis para instalação na sua máquina nos pacotes
<a href="http://packages.debian.org/stable/doc/doc-linux-text">
doc-linux-text</a> e
<a href="http://packages.debian.org/stable/doc/doc-linux-html">
doc-linux-html</a>.

Há também <a href="http://ldp-br.conectiva.com.br/documentos/comofazer">HOWTOs 
traduzidos para o português</a> (chamados de Como Fazer). Esses são produzidos 
com o esforço coordenado pelo <a href="http://ldp-br.conectiva.com.br">LDP-BR</a>.
Eles estão disponíveis nos pacotes
<a href="http://packages.debian.org/stable/doc/doc-linux-text">
doc-linux-text-pt</a> e
<a href="http://packages.debian.org/stable/doc/doc-linux-html">
doc-linux-html-pt</a>.

# TODO: falar do projeto de documentação português!


<H2><a name="faqs">FAQs</a></H2>

<p>FAQ significa <em>frequently asked questions</em> (perguntas feitas
frequentemente). Um FAQ é um documento que responde a essas perguntas.

<p>O <a href="http://www.tldp.org/FAQ/Linux-FAQ/">Linux FAQ</a>
contém informações sobre o GNU/Linux em geral.</p>

<p>Perguntas relacionadas especificamente ao Debian são respondidas 
na <a href="FAQ/">Debian FAQ</a>. Também está disponível uma <a 
href="../CD/faq/">FAQ sobre as imagens de CD/DVD do Debian</a>.</p>

<p>Por favor, veja o <a href="http://www.tldp.org/FAQ/">índice de FAQs do 
LDP</a> para mais informações.


<H2><a name="other">Outros documentos menores</a></H2>

<p>Os documentos seguintes incluem instruções mais rápidas e pequenas:

<dl>
  <dt><strong><a href="http://www.tldp.org/docs.html#man">páginas de manual</a></strong></dt>
    <dd>Tradicionalmente, todos os programas Unix são documentados com
    <em>páginas de manual</em>, manuais de referência estão disponíveis
    pelo comando <tt>man</tt>. Eles não são para novatos, normalmente.
    </dd>

  <dt><strong>arquivos README variados</strong></dt>
    <dd>Os arquivos <em>leia me</em> são comuns, também -- eles são
    arquivos de texto simples que descrevem um item único, normalmente
    um pacote. Você pode achar muitos deles nos subdiretórios de
    <tt>/usr/share/doc</tt> em seu sistema Debian.
    </dd>
</dl>

# TODO: the link to installguide is probably misplaced
<p>Você pode estar interessado no
<a href="../releases/potato/installguide/">guia de instalação para o Debian
2.2</a>, que é um tutorial online.

<hrline>

<P>Se você conferiu os recursos acima e ainda não achou respostas para
suas perguntas ou soluções para os seus problemas sobre o Debian, dê uma
olhada na nossa <A HREF="../support">página de suporte</A>.