Why This Chapter Is Important
Back in the days of mainframes and very formal centralized management information systems (MIS) departments, documentation was a mandatory requirement for the completion of an application. Today, it seems as though all types of people are developing applications: administrative assistants, CEOs, sales managers, MIS professionals, and so on. To make matters worse, many of us who consider ourselves MIS professionals never received any formal systems training. Finally, the demand to get an application up and running and then to move on to the next application is more prevalent than ever. As a result of all these factors, it seems that documentation has gone by the wayside.Despite all the reasons why documentation doesn't seem to happen, it is as important to properly document your application today as it was in the mainframe days. Documentation provides you and your users with these benefits:
- It makes the system easy for you and others to maintain.
- It helps state the purpose and function of each object in the application.
This chapter covers the various ways in which you can document your application objects and code.