In college, there was a course called Software engineering, which we called documentation Engineering.
Feasibility analysis, demand analysis, summary design, detailed design ... Throughout the course each group wrote various documents for one semester. This is the name of the document project.
Today, writing documents is still a painful thing for everyone, not to mention the age of students who have no project experience.
However, there is better documentation than no documentation. While most documents may be of poor quality or lack of maintenance updates. There is at least one reference relative to the direct read code.
After the experience and the cooperation project, others do not say, for the document is really admire, very comprehensive, a variety of guideline documents. Even so, the project was still struggling to become a tar pit.
As the classic "Human Moon Myth" describes the general, found that the reality of the project is still the same, a few decades ago, software engineering problems and now no difference.
Engineering is also science.
Software Engineering and Documentation project