Patterns to support team collaboration.
Name |
Short Description |
|
A document is considered to follow the agile principle if it is valuable, essential, and created or updated just-in-time. A documentation is created and maintained in an agile way, if all its documents follow this practice. |
|
To make it easier for readers to determine the relevance of a document, there should be short description for each document. |
|
To set the expectation right it is useful to communicate the state of each document to the collaborating authors and the readers. |
|
All publishing organizations define a style guide for their published information. Such a guide supports teams to write in a similar tone, making it easier for readers to digest the information. |
|
Make it easy for knowledge workers to focus on content and remove the need to define the document structure and formatting on a ad-hoc basis. |
|
To enforce a common understanding of the domain, a glossary should define the terms important for the project. This also supports the ubiquitous language and makes sure nobody is left behind. |
|
Do not render text to the reader that has no information value. |
|
Documentation is often created in a process of constant change. Therefore project documentation is never complete. |
|
A standard layout makes it easier for new members of a team to find information. A standard layout is project independent and is typically defined by an organisation. |
|
Define a basic structure for all artifacts of a given type. Readers will have an easier job on finding and learning about the information in your documentation. |
|
Experts need the freedom to employ the set of tools they work most effectively and efficiently. |