Jump to: navigation, search

Documentation/NewtonDeliverables

< Documentation
Revision as of 13:12, 5 August 2016 by Ogusarenko (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

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

Installation Tutorial

Contributor Guide

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

  • Docbook XML tool removal
  • OpenStackdocstheme work
  • Create cookiecutter template for project-specific install guides
  • Config option to mark documents as deprecated (assuming we will work out how to uniformly decide that)
  • Match guidelines for consistent RST file naming by renaming RST files from underbar to hyphen in openstack-manuals repository.
  • Have Infra team get site off Cloud Sites, for HTTPS and the ability to delete properly. Spec: http://specs.openstack.org/openstack-infra/infra-specs/specs/doc-publishing.html