Project documentation for each part of the project: technical / user / test documentation
Description:
How should a web application look, work and what does it want to achieve? At the beginning, only the manager has all this in his head, and it is impossible for the project to depend on one person who is the bearer of the idea.
In addition, if the human factor comes into play and the project is long-lasting, we don't have to remember everything. Project documentation should be a part of every project – the description of user stories, the description of the UX design, testing and technical documentation.
Links:
https://www.projectmanager.com/blog/great-project-documentation,
https://www.indeed.com/career-advice/career-development/project-documentation
Keywords:
Project management, documentation, project maintenance, software development, software testing
Motivation:
Software development is a very specific part and there is no doubt about the importance of project documentation – for testers, developers and managers. Keeping and maintaining documentation may seem time-consuming, but as a result, it saves time not only for the manager, but also for the development team.
Requirements/Prerequisities:
Nothing specific, just the ability to write factually and concisely
Level:
generic: high level abstract best practice, metalevel category (e.g. manage architectures)
Application domain:
Medicine/Healthcare, Education (Technology enhanced learning), Data science (analysis & visualisation), Software engineering
Main phase:
Generic: Requirements/Exploration, Generic: Design/Plan, Development: Implementation/Code/Build, Development: Testing
Related literature:
https://www.sciencedirect.com/science/article/pii/S0164121299000941
https://dl.acm.org/doi/abs/10.1145/585058.585065
In which projects do/did you use this practice?
SIMUportfolio
Data Analyst, Project Manager, Researcher
3–5 years of experiences
Masaryk University
1. How do you rate the potential benefit for your projects? | 5 |
2. How often are you using that practice? | 4 |
3. What is the effort to introduce the practice in your project upfront? | 3 |
4. What is the effort to apply the best practice in your project daily basis? | 4 |
Questions 1, 3 and 4 (1 = Low, 5 = High)
Question 2 (1 = Never, 5 = Always)