This shows you the differences between two versions of the page.
Next revision | Previous revision Last revision Both sides next revision | ||
documentation:opnfvdocs [2015/04/01 22:58] Christopher Price created |
documentation:opnfvdocs [2016/03/24 10:43] Sofia Wallin |
||
---|---|---|---|
Line 1: | Line 1: | ||
==== OPNFV documentation project ==== | ==== OPNFV documentation project ==== | ||
- | |||
=== Project description: === | === Project description: === | ||
* Produce documentation for OPNFV releases including but not limited to: | * Produce documentation for OPNFV releases including but not limited to: | ||
* Release notes | * Release notes | ||
- | * Installation guide | + | * Configuration guide |
* User guide | * User guide | ||
* Any relevant references and interface specifications for OPNFV projects or components. | * Any relevant references and interface specifications for OPNFV projects or components. | ||
* Include any architecture diagrams or specifications, reference to OPNFV requirements list. | * Include any architecture diagrams or specifications, reference to OPNFV requirements list. | ||
* Provide guidelines and tooling for documentation handling across all OPNFV projects | * Provide guidelines and tooling for documentation handling across all OPNFV projects | ||
+ | |||
+ | === Current OPNFV documentation library === | ||
+ | |||
+ | [[https://wiki.opnfv.org/documentation/library]] | ||
=== Current plans: === | === Current plans: === | ||
Line 17: | Line 20: | ||
* Structure OPNFV documentation logically | * Structure OPNFV documentation logically | ||
* Develop initial set of release documents: | * Develop initial set of release documents: | ||
- | * (A) Release note | + | * (A) Release note - should be mostly a template in opnfvdocs and read in from the different areas -release components, ISO toolchain contents, test coverage, links to other docs |
- | * (B) Install guide | + | * (B) Install guide - should contain sections on: getting the software: centrally done in opnfvdocs, preparing your hardware: taken from pharos, installing the ISO: taken from each ISO directory, validating the install: taken from functest |
- | * (C) User Guide | + | * (C) User Guide - overview of the platform: central overview of tools taken from each ISO directory. instruction on deploying to the platform: maybe taken from functest |
* Provide language options for documentation where applicable: In first release English only, Wiki (via HTML scraping from Gerrit), and PDF. | * Provide language options for documentation where applicable: In first release English only, Wiki (via HTML scraping from Gerrit), and PDF. | ||
* Provide tooling and processes for OPNFV projects to implement and follow for consistency | * Provide tooling and processes for OPNFV projects to implement and follow for consistency | ||
Line 34: | Line 37: | ||
* Bryan Sullivan (AT&T) | * Bryan Sullivan (AT&T) | ||
* Trevor Cooper: trevor.cooper@intel.com | * Trevor Cooper: trevor.cooper@intel.com | ||
+ | * Victor Laza <vlaza@cloudbasesolutions.com> | ||
+ | * Natasha Peters: natasha.c.peters@gmail.com | ||
Description of roles in the documentation project: | Description of roles in the documentation project: | ||
Line 40: | Line 45: | ||
* opnfvdocs contributors: individual section will have contributors who are domain experts in those areas, other contributors may simply help out working on the documentation and tools as needed. | * opnfvdocs contributors: individual section will have contributors who are domain experts in those areas, other contributors may simply help out working on the documentation and tools as needed. | ||
* other projects: Committers will be responsible for maintaining documentation artifacts in project repositories. | * other projects: Committers will be responsible for maintaining documentation artifacts in project repositories. | ||
- | |||