# Documentação

A documentação, infelizmente, pertence às questões mais subestimadas da programação. Contudo, uma vez configurada devidamente e mantida a nível interno e externo, a documentação oferece uma ajuda muito valiosa.

A documentação tem várias facetas. Existe a

- documentação interna do projecto, que consiste principalmente em

  - comentários nos ficheiros de código/inclusão

  - documentação interna da &API; do seu projecto, gerada a partir dos ficheiros do programa com ferramentas especiais, ⪚ &doxygen;

- documentação externa do projecto, que inclui, entre outras

  - a documentação externa da &API; de ⪚ bibliotecas do sistema comuns (&kde;, &Qt;, &etc;)

  - qualquer outra documentação (manuais da linguagem de programação, informação de sistema geral, artigos e tutoriais, entre outros)

Toda esta documentação deverá ser fácil de manter e prontamente disponível sempre que necessitar dela. O &kdevelop; tem todas as capacidades para tal.

## O Navegador de Documentação

### Uma Imagem da Árvore de Documentação