Quiz 08 - Markdown Moderno para Computação
1. Qual a maior vantagem de dividir a documentação em múltiplos arquivos?
Gastar mais memória no HD.
Facilitar a manutenção e não sobrecarregar o usuário com excesso de informação em uma única página.
É uma regra obrigatória do Windows.
Deixa o arquivo mais difícil de hackear.
2. Por que links relativos (ex: ./docs/setup.md) são melhores que links absolutos?
Porque eles funcionam apenas no seu computador.
Porque eles permitem que o projeto funcione em qualquer computador ou servidor (como o GitHub) sem quebrar.
Porque são mais curtos.
Porque o Markdown não aceita links absolutos.
3. Como uma Checklist ajuda no "Sentimento de Progresso" do usuário?
Ela obriga o usuário a trabalhar mais.
Ela permite visualizar claramente o que já foi feito e o que falta terminar.
Ela muda a cor da tela.
Ela envia notificações para o celular.
4. Em um projeto profissional, onde deve ficar a explicação técnica das funções?
No topo do README.md.
Em arquivos dedicados (ex: api.md ou referencia.md) dentro da pasta docs/.
Em um comentário escondido.
No título do arquivo.
5. Qual o papel do diagrama Mermaid em uma documentação de projeto intermediário?
Substituir todo o texto.
Facilitar o entendimento visual de fluxos complexos ou arquitetura de pastas.
Deixar o site mais pesado.
É apenas um desenho decorativo.
6. O que compõe a "Tríade de Ouro" de um README de sucesso?
Nome do autor, data e hora.
Título/Badge, O que faz, e Como Instalar.
links para redes sociais, fotos das férias e música de fundo.
Apenas o código fonte.
7. Como garantir que um link de "Voltar ao Início" funcione em qualquer página da `docs/`?
Usando o link fixo `https://google.com`.
Usando o caminho relativo correto para o `index.md` ou `../README.md`.
Reiniciando o computador.
Usando a barra de endereços do navegador.
8. Qual a importância do destaque de sintaxe em uma referência de API?
Nenhuma, o código é lido igual.
Melhora a legibilidade e ajuda a identificar rapidamente palavras-chave, strings e funções.
Evita que o código tenha erros.
É uma regra de design do Pinterest.
9. O que é uma "Versão Intermediária" (v0.5) de uma documentação?
Uma documentação que só tem a metade do texto.
Um estágio onde os recursos fundamentais estão prontos, mas faltam recursos avançados (como automações ou vídeos).
Um arquivo que foi deletado por engano.
O nome da próxima aula.
10. Por que aprender a documentar é tão importante quanto aprender a programar?
Para passar o tempo.
Porque código sem documentação é difícil de manter e impossível de escalar em equipe.
Porque paga mais que programação.
Porque é mais fácil.