Quiz 14 - Introdução
1. Qual a melhor definição para a frase "O código se documenta sozinho"?
Uma verdade absoluta, nunca precisamos escrever documentos.
Um mito perigoso. Código limpo ajuda, mas documentação de contexto é essencial.
O código fala com a gente usando IA.
Documentação é proibida no Ágil.
2. O que deve conter um arquivo README.md?
A história da vida do programador.
Receitas de bolo.
Resumo do projeto, como instalar e usar.
Versículos bíblicos.
3. Para quem é voltada a Documentação de API?
Para o cliente final (dona de casa).
Para outros desenvolvedores que vão integrar com seu sistema.
Para o gerente de vendas.
Para ninguém.
4. O que é Markdown?
Uma marca de roupa.
Uma linguagem de marcação leve usada para formatar textos (como este aqui).
Um código difícil de ler.
Um banco de dados.
5. Qual a diferença entre documentação de Usuário e Técnica?
De usuário é para quem usa o software; Técnica é para quem constrói/mantém.
Não há diferença.
Técnica deve ser escrita em latim.
De usuário deve ser escrita em código.
Gabarito:
- 1- Um mito perigoso. Código limpo ajuda, mas documentação de contexto é essencial.
- 2- Resumo do projeto, como instalar e usar.
- 3- Para outros desenvolvedores que vão integrar com seu sistema.
- 4- Uma linguagem de marcação leve usada para formatar textos (como este aqui).
- 5- De usuário é para quem usa o software; Técnica é para quem constrói/mantém.