A criação de um sistema operacional livre de alta qualidade também inclui
escrever manuais técnicos que descrevam a operação e o uso dos programas. O
projeto Debian dedica todos os esforços para fornecer a todos(as) os(às)
usuários(as) uma boa documentação em um formato facilmente acessível. Esta
página contém uma coleção de links que levam a guias de instalação, HOWTOs,
FAQs, notas de lançamento, nossa wiki e muito mais.
Tenha estes à mão quando fizer sua primeira instalação Debian, eles
provavelmente responderão a várias questões e ajudarão a trabalhar com seu
novo sistema Debian.
A seguir, você pode passar por estes documentos:
Referência Debian,
um guia do(a) usuário(a) conciso com foco em linha de comando shell
Notas de lançamento,
geralmente publicadas com atualizações do Debian, visando usuários(as)
que estão atualizando a distribuição
A maior parte da documentação incluída no Debian foi escrita para GNU/Linux em
geral, mas também existe alguma documentação escrita especificamente para o
Debian. Basicamente, os documentos são classificados nessas categorias:
Manuais: esses guias se assemelham a livros, pois descrevem os principais
tópicos de forma abrangente. Muitos manuais listados abaixo estão disponíveis
tanto on-line como em pacotes Debian. De fato, a maioria dos manuais no site
web são extraídos de seus respectivos pacotes Debian. Escolha um manual
abaixo para o nome do seu pacote e/ou links para as versões on-line.
HOWTOs: como o nome indica, os
documentos HOWTO
descrevem como fazer uma coisa em particular, ou seja, oferecem
conselhos detalhados e práticos sobre como fazer algo.
FAQs: compilamos vários documentos respondendo a
perguntas frequentes. As perguntas relacionadas ao Debian são
respondidas no FAQ do Debian. Além disso,
há um FAQ separado sobre imagens de CD/DVD do Debian
respondendo a todos os tipos de perguntas sobre mídia de instalação.
Outros documentos (mais curtos): verifique também a
lista de instruções mais curtas.
Os documentos seguintes incluem instruções mais rápidas e curtas:
Páginas de manual (manpages)
Tradicionalmente, todos os programas Unix são documentados com
páginas de manual, manuais de referência disponíveis através do
comando man. Eles normalmente não são para novatos(as), mas
documentam todos os recursos e funções de um comando. O repositório
completo de todas páginas de manual disponíveis no Debian estão on-line:
https://manpages.debian.org/.
Muitos programas GNU são documentados através de arquivos info
em vez de páginas de manual. Esses arquivos incluem informações
detalhadas sobre o programa, opções e exemplos de uso, e estão
disponíveis através do comando info.
Arquivos LEIA-ME (README)
Os arquivos LEIA-ME são arquivos de texto simples que descrevem um
item, normalmente um pacote. Você pode encontrar muitos deles nos
subdiretórios em /usr/share/doc/ no seu sistema Debian.
Adicionalmente ao arquivo LEIA-ME, alguns desses diretórios incluem
exemplos de configuração. Por favor note que a documentação de programas
maiores é geralmente fornecida em um pacote separado (com o mesmo nome
do pacote original, mas terminado com -doc).