Confluence documentation
As the quote states, the importance of documentation is unprecedented. When working on problems and gaining new insights, write down the findings so later you don’t have to remember the ten steps you went through the first time but just to remember the one step Look up the Confluence Documentation!
Guidelines
When writing Confluence Documentation the agreed upon guidelines on the company level should serve as a compass:
EVERY new functionality in the project should be properly documented on Confluence.
When to write it down
Bug resolution: Provide detailed description of bug resolutions, including steps taken, encountered issues and solutions, along with relevant resource links.
New functionality development: Document the functionality, including publicly available APIs and internal workings to facilitate user understanding and easier system integration.
Technological exploration: Document insights and usage tutorials when incorporating new technologies or external libraries into the project.
Understanding the significance
To remember why documentation is so important, here are some points referenced from the Atlassian article (Importance of Documentation - The Workstream):
A single source of truth saves time and energy - Documentation serves as a single source of truth, streamlining collaboration and decision-making processes.
Documentation is essential to quality and process control - Documentation fosters consistency and adherence to established protocols, enhancing overall quality and process efficiency.
Documentation cuts down duplicative work - By providing a reference point for past experiences and solutions, documentation minimizes duplicative efforts and accelerates problem resolution.
It makes hiring and onboarding so much easier - Well-documented processes and procedures expedite the onboarding process, enabling smoother transitions and knowledge transfer among team members.
Don’t write down redundant documentation - Redundant documentation can overwhelm users with unnecessary details, making it harder for them to find relevant information efficiently.
Last updated