Jump to: navigation, search

Difference between revisions of "Documentation/NewtonDeliverables"

(Docs Tools/Infra)
(Ops and Arch Guides)
Line 3: Line 3:
 
==Ops and Arch Guides==
 
==Ops and Arch Guides==
 
* Review content of both guides, and delete anything out of date
 
* Review content of both guides, and delete anything out of date
* Review architecture of both guides, and possibly combine
+
* <s>Review architecture of both guides, and possibly combine</s>
 
* <s>Move Ops Guide into openstack-manuals repo</s>
 
* <s>Move Ops Guide into openstack-manuals repo</s>
 
* Gather content from Ops internal documentation
 
* Gather content from Ops internal documentation

Revision as of 03:23, 27 May 2016

Newton Docs Deliverables

Ops and Arch Guides

  • Review content of both guides, and delete anything out of date
  • Review architecture of both guides, and possibly combine
  • Move Ops Guide into openstack-manuals repo
  • Gather content from Ops internal documentation

HA Guide

  • Move HA Guide into openstack-manuals

Install Guide

Contributor Guide

  • UI/UX section improvement
  • Improve documentation of docs tools/theme etc
  • Add diagram recommendations
  • Document new Install Guide process
  • Process discussions: Who should follow this guide? Introduction of a minimal review time? Section about contribution recommendations: what devs should contribute, review expectations of docs, expected turn-around time, etc. How to deprecate/remove docs? Also define which are continuous-release, versioned, etc.

Security Guide

  • Pull printed guide.
  • Updating neutron section

API Docs

User Guides

  • Work with the Ops Guide to check for duplicated content
  • Check for missing content and out of date content - fix links
  • Bring new service projects into the User Guides - esp. projects that have info in dev docs that could be moved into the user guide
  • IA plan - consistency, links, findability plus tables, code snippets, naming conventions (use contributor guide)

Docs Tools/Infra