Gostaria de fazer minha pergunta com base nessa questão sobre testes.
Existem diferentes maneiras de documentar um software, as que mais observei são:
- Documentação da classe (o desenvolvedor comenta qual o objetivo e/ou tarefa daquela classe)
- Documentação do método (o desenvolvedor comenta qual o objetivo, ações e/ou tarefas que aquele método realiza)
- Documentação dentro do código (o desenvolvedor comenta o que ocorre em determinada linha de código)
- Documentação gerada de maneira automatizada a partir do Javadocs, por exemplo.
Portanto, baseando sobre algumas perguntas do link que mencionei acima:
- Qual seria uma boa forma de documentar o software?
- É interessante colocar documentação no código? É útil somente para desenvolvedores inexperientes em início de carreira ou também para desenvolvedores experientes que já tem domínio na linguagem? Pergunto isso porque já ouvi falarem que não precisa de documentação porque lendo o código você já sabe qual ação aquele trecho de código realiza. Porém pelo que observo a arquitetura do sistema tem a sua influencia, a maneira como o desenvolvedor desenvolveu aquilo, posso citar exemplo o conceito de MVC, Injeção de Dependência que possuem as suas arquiteturas, assim o desenvolvedor poderia criar uma arquitetura diferente para um padrão de projeto dentro da aplicação.
- Existem critérios para tal?
- Como base na melhor resposta da pergunta que mencionei sobre testes, dentro da documentação de sistemas existem descrições, como, por exemplo, Teste de Integração, Teste Unitário, Canary Release que foram mencionados na resposta? Porém nessa pergunta que criei referindo-se a documentação.