Documentation Development: Difference between revisions

From Open Source Ecology
Jump to navigation Jump to search
No edit summary
No edit summary
Line 7: Line 7:
*How easily can the user edit the information to revise the documentation?
*How easily can the user edit the information to revise the documentation?


*How easily can the user make a separate copy of the information to use parts of the documentation as a separate project?
*How easily can the user make a separate copy of the information to use parts of the documentation for a separate project?
 
=Analysis=
 
Webpages are currently the most accessible form of documentation.
 
Webpages provide 2D visual information with audio.
 
ACCESSIBILITY: A web browser is the major requirement.
 
NAVIGABILITY: A table of contents acts as an index.
 
EDITABILITY: With wiki software, a set of webpages can be made editable.
 
COPYABILITY: Text and images can be copied. The webpage information can be downloaded as an html file.

Revision as of 05:37, 17 September 2012

Open Source Documentation Objectives

  • How accessible are the requirements to use the documentation? (ex. particular computer hardware and software)
  • How easily can the user navigate the information to find what they want to know?
  • How easily can the user edit the information to revise the documentation?
  • How easily can the user make a separate copy of the information to use parts of the documentation for a separate project?

Analysis

Webpages are currently the most accessible form of documentation.

Webpages provide 2D visual information with audio.

ACCESSIBILITY: A web browser is the major requirement.

NAVIGABILITY: A table of contents acts as an index.

EDITABILITY: With wiki software, a set of webpages can be made editable.

COPYABILITY: Text and images can be copied. The webpage information can be downloaded as an html file.