Translation(s): English - Français - Italiano - Português (Brasil)
Documentação do Debian
O Debian é uma distribuição GNU/Linux feita por milhares de pacotes de software livre.
Esta página é sobre a documentação oficial do Debian.
Há outros recursos sobre o Debian.
Para usuários(as)
As documentações mais famosas para usuários(as) do Debian são:
O guia de instalação (ou sua versão de desenvolvimento - indisponível).
Muitas outras documentações do Debian estão disponíveis em www.debian.org/doc
No momento, o Debian não tem um manual de administrador(a) de sistema.
Para contribuidores(as)
As documentações mais famosas para contribuição ao Debian são:
a A Definição Debian de Software Livre (Debian Free Software Guidelines - DFSG)
as Políticas de uso das máquinas Debian (dmup)
A maior parte da documentação para desenvolvedores(as) Debian (e mantenedores(as) de pacotes) estão disponíveis em www.debian.org/devel/.
Sites web oficiais do Projeto Debian
O Projeto Debian tem uma constituição e uma estrutura organizacional.
Em Debian.org, o site oficial do Debian, você pode encontrar uma seção dedicada à documentação.
https://www.debian.org/doc/index.pt.html - página principal da documentação do Debian
https://www.debian.org/support.pt.html - página principal de suporte
Fórum
As listas de discussão são a principal forma de comunicação no Debian
https://lists.debian.org/users.html - listas de discussão de usuários(as)
https://lists.debian.org/debian-user-portuguese - lista de discussão de usuários(as) em português
https://forums.debian.net - fóruns do Debian.net
Apadrinhamento, desenvolvedores(as), informações internas
UnofficialRepositories - uma lista de repositórios não oficiais de pacotes. Podem ser muito úteis.
https://alioth.debian.org (indisponível) - Projeto de hospedagem para desenvolvedores(as) de código aberto
https://mentors.debian.net - Repositório de pacotes públicos
https://bits.debian.org - Blog do Debian
https://planet.debian.org - Planet Debian, agregando muitos blogs de desenvolvedores(as)
https://planet.debian.org/es - Planeta Debian, um agregador de blogs em espanhol
https://release.debian.org - páginas de administração de lançamentos do Debian
https://snapshot.debian.org - Pacotes do Debian arquivados diariamente desde 04/06/2002
https://backports.debian.org- Backports para a distribuição estável (stable)
https://www.debian.org/News - Notícias oficiais
https://db.debian.org - Banco de dados de desenvolvedores(as) Debian
https://udd.debian.org - Banco de dados Ultimate do Debian
Wiki
Wikis relacionados ao Debian:
https://wiki.debconf.org - O wiki pré-2019 da DebConf (Conferência Debian). Para conteúdo a partir de 2019, veja DebConf.
https://wiki.debian.org - O wiki oficial do Debian
Livros
Muitos livros, livres e não livres, estão listados no site web do Debian.
https://www.debian.org/doc/books.pt.html - Biblioteca de livros do Debian
Mais livros podem ser listados abaixo.
Mensagens instantâneas
Existem canais oficiais de IRC do Debian.
Você também pode usar Jabber
Documentação de programas
Cada software fornece sua própria documentação.
Sob o Debian (Unix), uma documentação de programa tipicamente consiste de (uma ou mais de):
Uma página man (manpage) (digite man seguido por um nome de comando).
Um arquivo README, fornecido pelo(a) autor(a) original. (Um arquivo texto localizado em /usr/share/doc/nomedopacote/README)
Um arquivo README.Debian, fornecido pelo(a) mantenedor(a) do pacote Debian. (Um arquivo texto localizado em /usr/share/doc/nomedopacote/README.Debian)
Programas com interfaces gráficas de usuário(a) (Gnome, KDE...) normalmente vêm com páginas de ajuda (acessíveis através de Menu > Ajuda).
Alguns programas fornecem sua documentação como html ou páginas info.
Descrição de pacotes
Na descrição de pacotes você pode encontrar algumas informações úteis como uma descrição curta do pacote, um link para o site web original, uma lista de arquivos ali contidos, e mais. A descrição do pacote pode ser acessada na url https://packages.debian.org/<nome-do-pacote>. Ou tente "aptitude show $PACOTE" (você pode precisar executar primeiro "apt-get update && apt-get aptitude && aptitude update").
Um dos melhores lugares para procurar por ajuda para um único pacote ou aplicação é ler coisas em /usr/share/doc/<nome-do-pacote> (especialmente README.Debian). Esta é a documentação escrita por desenvolvedores(as) ou mantenedores(as) de pacotes. É muito concisa, mas usualmente menciona problemas e soluções mais comuns, e novas funcionalidades e bugs corrigidos.
Sistema de rastreamento de bugs
Muitas soluções de problemas podem ser encontrados como respostas a relatórios de bug. Um motor de busca para relatórios de bug é encontrado em https://bugs.debian.org. Lembre-se de que se quiser procurar por bugs arquivados (muito antigos), você deve escolher a opção "bugs arquivados". Se quiser procurar por bugs de pacote específicos, use https://bugs.debian.org/<nome-do-pacote>.
Contribua para a documentação
Isto é software livre, você pode contribuir com melhorias para a documentação existente.
(ou seja, você não tem que escrever seu próprio HowTo!).
Se você tem interesse em contribuir para a documentação, por favor verifique primeiro os seguintes recursos para entender como outras pessoas contribuem:
https://www.debian.org/doc/ddp.pt.html (a maior parte da documentação do Debian está disponível aqui)
https://wiki.debian.org (junte-se a este wiki e adicione novos conteúdos/traduções)
https://lists.debian.org/debian-www/recent (listas de discussão)
https://lists.debian.org/debian-doc/recent (listas de discussão)
Alguns conteúdos da documentação são gerados a partir de pacotes do Debian. Nesse caso, você pode desejar interagir com o(a) mantenedor(a) do pacote. Às vezes é uma boa ideia preencher um relatório de bug usando o sistema de rastreamento de bugs do Debian (BTS).
Se você tem interesse em participar do grupo debian-doc, por favor veja a página do time no wiki.