Verified Document

Software Documentation Is An Integral Part Of Essay

Software documentation is an integral part of the software development process. However, the process is often challenging because over the course of a software development project the scope can often change and evolve several times with updates and new builds. Despite the challenges that are presented in effectively documenting the development process, the documentation that is produced can serve as a valuable asset that can be used in future projects or future alterations of the current software package. Not only is it important to accurately and clearly document many of the development steps but it is also important to make sure the right people have access and knowledge of the documentation that has been created. Even if the documentation was produced accurately and clearly it is not of much value if it is not accessible or utilized later. This analysis will cover some of the challenges that are present in this process as well as some of the best practices and new developments that can facilitate effective documentation. Challenges in Documentation

One of the challenges in documenting the software development process stems from the fact that software engineers are generally more concerned with the project and the requirements than the documentation process. This is a reasonable perspective given the fact that the project members are focused making the project a...

Parts of this document are hidden

View Full Document
svg-one

Therefore the focus is generally on software-engineering related activities and the documentation process is generally an afterthought. Many software engineers find the documentation process as something of a waste of time and relatively meaningless.
Furthermore, another challenge is that software engineers generally receive little training in the documentation process. Generally in schools the course of study is focused on the software engineering skills and again the documentation process is more of an afterthought that receives little attention. Although schools may state the importance of properly documenting a development project, there is generally relatively little time and attention devoted to learning effective documentation skills. In fact, it is commonly the case that the documentation is only produced after the software development project is already completed.

The negligence of the documentation process can be verified by several research studies. One study found that over the course of twenty years of software evolutions in an industrial setting at a nuclear power plant that there were virtually no documented modifications to the source code (Pawlik, et al., 2012). Another study found that professional end-user developers did not voluntarily produce documentation for any modification and only…

Sources used in this document:
Works Cited

Pawlik, A., Segal, J. & Petre, M., 2012. Documentation Practices in Scientific Software Development. CHASE, Volume 2012 5th InternationalWorkshop on Co-operative and Human Aspects of Software Engineering, pp. 113-119.

Rettich, K., 2011. Using the Wiki to Deliver Paperless Software Documentation. IPCC, Volume Professional Communication Conference (IPCC), 2011 IEEE International, pp. 1-8.
Cite this Document:
Copy Bibliography Citation

Related Documents

Software Development Life Cycle
Words: 2835 Length: 10 Document Type: Essay

Software Development Life Cycle Agile Software Development Agile software development is a popular software development process or methodology that has gained a lot of popularity in the recent years due to its effectiveness and ease of use. Firstly, it encourages collaboration and teamwork throughout the life cycle of development and this makes it easy to plan and implement. Agile software development is all about breaking a task into small chunks that make it

Software Testing in the Product
Words: 4713 Length: 17 Document Type: Term Paper

(Pan, 1999; paraphrased) The point at which it is generally considered acceptable to stop testing has as its basis two criteria for stop-testing criteria which are those of: (1) when a threshold has been reached with the reliability; and (2) when the testing costs are not justified by reliability gains. V. Test Automation Overview The work of Carl J. Nagle states the fact that: "When developing our test strategy, we must minimize

Software Processing Methodology Understanding the Problem Klyne
Words: 7750 Length: 20 Document Type: Dissertation

Software Processing Methodology Understanding the Problem Klyne Smith, DSE Candidate Dr. Frank Coyle Technical Motivation Research and Contribution Methods Software Processing Methodologies Waterfall Methodology Strengths Weaknesses Opportunity Threats Iterative Methodology Strengths Weaknesses Opportunities Threats Model Methodology Strengths Weaknesses Opportunities Threats Where do we go from here (Spring 2010)? Define measurement data points for Test Case analysis Section IV Creation and Validation of the predictive model Section V Summary Analysis Practical Usage Praxis Conclusion Books Articles / Web Information Software Processing Methodology: Understanding the Problem Section I: Introduction In this work, I examine three different Software Processing Methodologies. I start with the iterative model, followed by the spiral

Progress & Obstacles in Software
Words: 2634 Length: 10 Document Type: Term Paper

Thus, providing development teams more problems during the testing process. Lee J. White, in his study Domain Testing and Several Outstanding Research Problems in Program Testing indicates that in the area of program testing, there are several significant problems which need to be addressed. White indicates some of these problems include the following. The determination of a scientifically sound basis for the selection of test data The development of program specifications which can

Explosive Impacts of Computer and Information Technology
Words: 3234 Length: 10 Document Type: Essay

Explosive impacts of computer and information technology on business and individuals have generated a need to design and develop new computer and software system to incorporate a rapid growing range of computer applications. Software engineers apply the software engineering principles and techniques to design, evaluate, test and implement software systems to enable computer to perform different applications. Software engineers use systematic and quantified approach to design, evaluate, implement software and

Computer Security People, Process and Technology Are
Words: 4780 Length: 15 Document Type: Capstone Project

Computer Security People, process and technology are three things which are involved in information security. Biometrics, passwords and firewalls are some of the technical measures and these are not enough in justifying threats to information. In order to protect information from destruction and to secure systems, a blend of different procedures is required. While deploying information security some factors need to be considered for instance processes like de-registration and registration

Sign Up for Unlimited Study Help

Our semester plans gives you unlimited, unrestricted access to our entire library of resources —writing tools, guides, example essays, tutorials, class notes, and more.

Get Started Now