Delivered System Documentation u One of the most important things that can be done to make a system maintainable is to create the best, most complete,
out of 18
Post on 15-Jan-2016
Delivered System Documentation One of the most important things that can be done to make a system maintainable is to create the best, most complete, set of documents that describes the system's design, development and testing. Delivered System DocumentationIn a well-done system, the documentation effort may equal the programming effort.Documentation standards differ from one software organization to another.Delivered System DocumentationWherever you go you will be expected to learn the local standards! Technical Manual a) includes a re-examination of the software specifications and design, complete with any changes that have been made. b) The specifications and design should not be rewritten to reflect the final implementation.Technical Manual c) Include explanations for changes that were made.d) Do everything you can to keep future software engineers from "reinventing the wheel" for this system.Technical ManualTable of Contents and IndexNo matter how good your document and program is, it needs to be organized so that things can be found.Report Testing EffortsThe major reason test documentation is needed during maintenance is so that regression testing can be conducted. Technical ManualAvoid re-inventing the wheel!Include implementation failures so they need not be repeated.User SupportSome major reasons for maintenance are: Unreasonable user expectations Poor user trainingUser SupportMaximize the chance that users will figure out what they need to know. Make manuals clearly written, well organized, well indexed SIMPLE.Restructuring SoftwareOver time the quality of software deteriorates! WHY?Restructuring SoftwareProblem: what happens --If code is patched with unstructured methods And/OrWith code that is NOT easily understood --Restructuring SoftwareThe code will become less and less understandable over time The probability of change resulting in a defect increases and the cost of adequate testing increases.Ultimately the software should be scrapped if the cost of upgrading it approaches the cost of starting over. Restructuring SoftwareThoughts: What can we do? 1) If changes require increasing the size of the module, consider reorganizing the code and splitting out functionally cohesive subsections. 2) Remember to update the relevant sections of all associated documentation.The Current Status of MaintenanceMaintenance is somewhat of an art -- as is programming itselfThe Current Status of MaintenanceMaintenance today includes work being done on programs that were written ten or twenty years ago.These programs, including such things as payroll systems and compilers, are large enough and used widely enough to be worth maintaining.The Current Status of MaintenanceBut, maintaining old code requires an understanding of the methodologies, languages and style in use at the time the software was written.The Current Status of MaintenanceMaintaining code is VERY hard work!The Current Status of MaintenanceSometimes, the only thing available for a system that needs maintenance is the object codeSometimes, the only information you may have about how a program works and what it does is to consult with users who will give often conflicting responses.
View more >
The Most Important Things to Consider When Most Important Things to Consider When Selecting a Jetter ...
AMERHIS - is one of the most important ... AmerHis is an advanced communications system, ... The system permits the assignment of resources
The Flight Control System is one of the most flight ... ??Web viewThe Flight Control System is one of the most flight-critical systems on the aircraft. ... word we use to define the ... is one of the most flight-critical systems on ...
? Web viewby Joyce Meyer. I believe one of the most important things I can teach you is that your thoughts…
Commercial Production Chapter 12. The most important thing to commercial stations is to make money. That is done through selling airtime commercials.
“There is only one important time, and that time is now. The most important one is always the one you are with. And the most important thing is to do good.
Recall that to be successful, all things must survive to reproduce Reproduction is just one phase of the life cycle but is perhaps the most important.
THE CANADIAN HEALTH CARE SYSTEM. HISTORY OF MEDICARE Health care is one of the most important issues to Canadians. Most of us believe that health care.
By: Krysten Brannick. to organize (things) so that the most important thing is done or dealt with first ****This is extremely important when balancing.
The Strength to say Yes to: Most Important things and No, to less Important Things P UTTING FIRST THINGS FIRST “Things which matter most must never be.