Enforcing documentation discipline in an organization



Rating - 3/5
510 views

Documentation discipline should be enforced in an organization. All employees should have a habit of making proper documentation of/in their work. 

These Topics Are Also In Your Syllabus
1 Sources of Software-Systems Acquisition link
2 Choosing Off-the-Shelf Software-Systems Acquisition link
You May Find Something Very Interesting Here. link
3 Reuse-Systems Acquisition link
4 Pine Valley Furniture Company Background-Managing the Information Systems Project link
5 Types Of Systems link

Lets say, How documentation required in Software developer’s work :

These Topics Are Also In Your Syllabus
1 Failure handling link
2 Concurrency link
You May Find Something Very Interesting Here. link
3 Transparency link
4 Quality of service link
5 Case study: The World Wide Web link
  1. First, Developer must have a proper SRS( software requirement specification) before writing to code.
  2. Developer should write proper comments in his code because it will be easier for the other developer(who will work next on the same code) to understand the existing code in a better way.  
  3. It is developers responsibility to properly document their software’s working means, how the software’s functionality works, prerequisite for the software etc.

Documentation management is necessary for organization because :

  1. Increase Collaboration & Communication
  2. Reliable Document Version Control
  3. Increase Time-Cost Savings
  4. Eases Accessibility
  5. Increase Productivity

So now the question is, How can we enforce Documentation discipline in an organization ? 

  1. organization should consider it as integral part of work.
  2. Proper resources should be made available to build document management system whether its human resource or technical resource
  3. procedures should be set up to create or review documentation
  4. Management should not be lenient on part of documentation, management should never say like  “ as time running short , so just create the system and make the documentation later”.
  5. Phase should not be considered complete until documentation is done.
  6. Coding should not be considered done unless its has required comment lines.

 

These Topics Are Also In Your Syllabus
1 Selected application domains and associated networked applications link
2 Massively multiplayer online games (MMOGs) link
You May Find Something Very Interesting Here. link
3 Financial trading link
4 Trends in distributed systems link
5 Pervasive networking and the modern Internet link

Rating - 3/5
499 views

Advertisements
Rating - 3/5