On 08/08/2017 03:28 AM, Thierry Carrez wrote:
Petr Kovar wrote:
Hi all,

With the core docs suite moving from openstack-manuals to individual
project repos as per
it's also time to update the docs team mission statement from

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

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 think the team needs to be more than "editors". I agree with the rest of the statement and the direction Thierry provides below:

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.

Note the doc team still has a few guides but I would not put emphasis on that, so the above is fine.

 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,
       HRB 21284 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126

OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe

Reply via email to