2
« on: July 01, 2009, 01:22:41 PM »
Hi All
Comments regarding the submitted documents
Group 1
----------
Only the guideline for the documentation standard has been provided. It would be great if if we have any sample technical documentation sample based on the recommended standard by group 1
Group 2
----------
This is my self criticism there are lots of thing can be added with the feasibility document. But I tried to keep the minimum I might have might have missed something obvious.
Group 3
----------
This is my self criticism. In the requirement analysis phase we might need to conduct customer interview. I have not recommended any standard document to capture such. I would recommend everyone to create a sample discussion form to capture customer interview.
Group 4
--------
Documents of group 4 seems to fine with me. We might skip some documents based on the project size.
Group 5
----------
This group has included lots of diagram which seems to be fine. Because I feel it depends of the project type what types of diagram to be used in the documentation for detail design. It is not recommended to use all the diagram but they have kept the provision.
Group 6
----------
I find the user manual bit complicated. Some basis information such as Installation guideline and how to use the system is missing form the documents. It become more or less administrative manual. Sorry folks. The heading that you have presented earlier in the workshop was better.
Group 7
---------
Work of group 7 seems to very intense. But being too practical it would be too hard to maintain all the test documents for the development team. I would recommend you suggest 1-2 documents to complete the test works. I feel it would be good if we could really complete all the forms.
I have already mentioned to make the documentation system workable we need to conduct training session for each of the documentation type and train the project managers and System Analyst to prepare the documentation for the development teams and programmers will be responsible for using and fill in the documentation. e.g. test scripts and test case should be generate by team leaders and test date and result should be filled up by the programmers.
Thanks
Aslam