Software documentation: Difference between revisions

Content deleted Content added
m Reverted 1 edit by 2405:4803:D7C6:6920:B108:C94E:7E30:D04C (talk) to last revision by Citation bot
 
(5 intermediate revisions by 5 users not shown)
Line 1:
{{Short description|Explains the functionality of software}}
{{more citations needed|date=March 2013}}
{{Software development process}}
'''Software documentation''' is written text or illustration that accompanies computer [[software]] or is embedded in the source code. The documentation either explains how the software operates or how to use it, and may mean different things to people in different roles.
 
[[Documentation]] is an important part of software engineering. Types of documentation include:
* [[Requirement]]s – Statements that identify attributes, capabilities, characteristics, or qualities of a system. This is the foundation for what will be or has been implemented.
* Architecture/Design – Overview of software. Includes relations to an environment and construction principles to be used in design of software components.
* Technical – Documentation of code, algorithms, interfaces, and [[API documentation|API]]sAPIs.
* End user – Manuals for the end-user, system administrators and support staff.
* Marketing – How to market the product and analysis of the market demand.
Line 89 ⟶ 88:
| first = Carlos
| title = The KDE Documentation Primer
| url = httphttps://i18n.kde.org/docs/doc-primer/index.html
| access-date = 15 June 2009 }}</ref>
# '''Thematic:''' A [[Theme (literature)|thematic]] approach, where chapters or sections concentrate on one particular area of interest, is of more general use to an intermediate user. Some authors prefer to convey their ideas through a knowledge based article to facilitate the user needs. This approach is usually practiced by a dynamic industry, such as [[Information technology]].<ref name=kbad>{{cite web