Application Documentation
Welcome guest blogger, Eileen Fitzgerald!
I’m sure many of you already know Eileen Fitzgerald. For those of you who don’t, she has been very involved in the Lotus Notes community for more than 12 years, and has been very involved with the Irish Local Users’ Group (ILUG). To learn more about Eileen, visit her LinkedIn profile.
Eileen has been involved with implementing ITIL at Lease Plan Corporation I am very happy to welcome Eileen as a guest blogger on Teamstudio’s governance blog.
Scott Johnsen
Application Documentation
Application documentation, how much is too little, too much and how much is just enough. When documenting applications, you normally require the documentation for some primary reasons such as:
read more
I’m sure many of you already know Eileen Fitzgerald. For those of you who don’t, she has been very involved in the Lotus Notes community for more than 12 years, and has been very involved with the Irish Local Users’ Group (ILUG). To learn more about Eileen, visit her LinkedIn profile.
Eileen has been involved with implementing ITIL at Lease Plan Corporation I am very happy to welcome Eileen as a guest blogger on Teamstudio’s governance blog.
Scott Johnsen
Application Documentation
Application documentation, how much is too little, too much and how much is just enough. When documenting applications, you normally require the documentation for some primary reasons such as:
- Compliance
- Knowledge Sharing
- Change Control
- Reference
- Risk Management
read more
But how much is enough and when do you get to the point where you are simply documenting for the sake of documenting? Over documenting is all an extreme waste of time and money adding no value to the company. It’s difficult but you need to find the balance between business, technical and compliance requirements.
First thing to do is identify the type of documents that are required to support your application. It is divided into Master documents (updated with releases) and Release documents specific to each release. Once you are in agreement with the types of documents that need to be in your application suite, we can look at what content needs to be in each document. I'm going to throw out a list of the types of documents your application suite should consist of. Let me know what you think.
Application Master Documents
Release Documents
First thing to do is identify the type of documents that are required to support your application. It is divided into Master documents (updated with releases) and Release documents specific to each release. Once you are in agreement with the types of documents that need to be in your application suite, we can look at what content needs to be in each document. I'm going to throw out a list of the types of documents your application suite should consist of. Let me know what you think.
Application Master Documents
- Security Document (Security management levels on the application.)
- System Design (System architecture.)
- Maintenance (Maintenance tasks associated with managing the application.)
- Operational (Day-to-day operational activities that the application performs, agents, data transfers, etc.)
- Version Management (How versions are managed in the application)
- User Manual
Release Documents
- Functional Changes
- Test Plan and Test Scripts
- Release Notes
Category Best Practices ITIL Documentation
Comments
Posted by Patrick Kwinten At 01:07:10 PM On 12/21/2008 | - Website - |
At the moment I'll be looking at the types of documents and basic content that is required per document vs actually posting templates.
I'd be interested in hearing what types of documents that you have accompanying your applicaitons if you would care to share that ?
Eileen
Posted by Eileen Fitzgerald At 01:39:45 PM On 12/22/2008 | - Website - |