Documentação
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.
Início rápido
Se você é novato(a) no Debian, recomendamos que comece com dois guias:
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
- Wiki do Debian, a wiki oficial do Debian
Manuais
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 USB/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.
Manuais específicos do Debian
Manuais para usuários(as)
- O manual para iniciantes do Debian Bookworm
- FAQ do Debian GNU/Linux
- Guia de instalação Debian
- Notas de lançamento do Debian
- Cartão de referência Debian
- O manual do(a) administrador(a) Debian
- Referência Debian
- Manual de segurança Debian
- Manual do(a) usuário(a) do aptitude
- Manual do(a) usuário(a) do APT
- FAQ do Debian GNU/Linux e Java
- Manual do(a) mantenedor(a) dos pacotes de Rádio Amador Debian
Manuais para desenvolvedores(as)
- Manual de políticas Debian
- Referência dos(as) desenvolvedores(as) Debian
- Guia dos(as) mantenedores(as) Debian
- Introdução ao empacotamento Debian
- Sistema de menu Debian
- Instaladores internos do Debian
- Guia para mantenedores(as) de pacotes que usam banco de dados
- Políticas para pacotes que usam banco de dados
Outros documentos (mais curtos)
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/.
- Arquivos info
- 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).