O projeto FreeBSD

Esta página contém os detalhes de um projeto de redação técnica aceito para a Google Season of Docs.

Resumo do projeto

Organização de código aberto:
O Projeto FreeBSD
Redator técnico:
The King of Toasters
(em inglês)
Nome do projeto:
Escrever páginas de manual ausentes, adicionar seções EXEMPLO às páginas de manual
Duração do projeto:
Duração padrão (três meses)

Project description

Escrever páginas man ausentes:

Há uma lista de manpages ausentes em https://wiki.freebsd.org/MissingManpages. Comece a escrever o maior número possível de páginas de manual dessa lista. Com a ajuda do mentor, encontre o autor ou alguém que tenha mudado recentemente o arquivo de origem que a página do manual em questão aborda para obter informações e detalhes.

Adicionar seções EXEMPLO às páginas do manual:

As páginas de manual do FreeBSD incluem em muitos lugares seções EXAMPLE, que descrevem o uso básico do utilitário ou comando descrito nelas. A wiki do FreeBSD tem uma lista de páginas de manual sem exemplos (https://wiki.freebsd.org/ManPagesWithoutExamples). Adicione o maior número possível de exemplos a essas páginas de manual nos casos em que eles façam sentido. Crie uma maneira geral de apresentar o comando/utilitário nessas seções (por exemplo, primeiro a introdução rápida, depois exemplos mais avançados) e aplique isso às páginas man que descrevem utilitários/comandos semelhantes. Dessa forma, os exemplos têm uma abordagem consistente e o leitor pode encontrar as coisas com mais facilidade.