DEV Community

Anja
Anja

Posted on

4

5 tips for a great software documentation

👩🏻‍💻Describe what your program does from start to finish. It needs to be so detailed that you could implement it based on the description.

📊Include architectural diagrams to enhance the understanding

📝Write down the steps of how to install, update and run the software

🖼Add screenshots

🖥Add infos about the servers used for development, testing and production

What would you like to add?

Top comments (4)

Collapse
 
____marcell profile image
Marcell Cruz

I like to start with a overview of the business side "why does this app exists?" I think it's a lot easier to understand how the app works if you understand why it was created

Collapse
 
anja profile image
Anja

Hi Marcell, that's a great idea, thanks for sharing! 😊

Collapse
 
prsaya profile image
Prasad Saya

👍 Your list sometimes is also referred as - requirements, design (high level and low level), user guide and developer's manual.

Collapse
 
anja profile image
Anja

Hi Prasad, yes thank you for the addition! 😊 👍

Billboard image

The Next Generation Developer Platform

Coherence is the first Platform-as-a-Service you can control. Unlike "black-box" platforms that are opinionated about the infra you can deploy, Coherence is powered by CNC, the open-source IaC framework, which offers limitless customization.

Learn more

👋 Kindness is contagious

Please leave a ❤️ or a friendly comment on this post if you found it helpful!

Okay