DEV Community

Ortiz de Arcanjo António David
Ortiz de Arcanjo António David

Posted on

2 1

Documentação de Software

Na medida que o software cresce, torna-se mais difícil ententer, manter e detectar erros. Grande parte destas questões é superada quando há uma documentação do sofware.

Ao contrário do que pensamos, a documentação de um software não é o código. Tendo em conta que existem milhares de linguagens de programação, o código pode não ser percebido por desenvolvedores de outras linguagens.

Devemos considerar que os Gestores ou Clientes não precisam ler exaustivamente cada linha de código para entender o software. A documentação deve ser percebida até para os não desenvolvedores.

A documentação não precisa ser complexa, muito formal ou focada em muitos detalhes desnecessários. Apenas precisamos documentar os aspectos que facilitam a compreensão do Software, tanto para os desenvolvedores quanto para os outros envolvidos.

As imagens abaixo apresentam uma sugestão simples para documentação de um software.

Documentação
Image description

Documentação do Software

Image description

Documentação da Base de Dados
Image description

Image of Timescale

🚀 pgai Vectorizer: SQLAlchemy and LiteLLM Make Vector Search Simple

We built pgai Vectorizer to simplify embedding management for AI applications—without needing a separate database or complex infrastructure. Since launch, developers have created over 3,000 vectorizers on Timescale Cloud, with many more self-hosted.

Read more →

Top comments (0)

Postmark Image

Speedy emails, satisfied customers

Are delayed transactional emails costing you user satisfaction? Postmark delivers your emails almost instantly, keeping your customers happy and connected.

Sign up