[openstack-dev] [docs] Updating the docs team mission statement

Thierry Carrez thierry at openstack.org
Tue Aug 8 10:28:58 UTC 2017


Petr Kovar wrote:
> Hi all,
> 
> With the core docs suite moving from openstack-manuals to individual
> project repos as per
> http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html,
> it's also time to update the docs team mission statement from
> https://governance.openstack.org/tc/reference/projects/documentation.html.
> 
> What are everybody's thoughts on what should the new mission statement
> say now that most OpenStack docs maintenance is in the hands of project
> teams?
> 
> One idea is for the docs team to act as a focused group of editors and
> maintain a common set of guidelines, recommended practices (style
> guidelines come to mind, for instance), and requirements (such as a common
> docs and publishing structure shared across projects).

I would say something like:

The docs team provides guidance, assistance, tooling, and style guides
enabling OpenStack project teams to produce consistent, accurate, and
high-quality documentation.

-- 
Thierry Carrez (ttx)



More information about the OpenStack-dev mailing list