[openstack-dev] [nova][docs] Is anyone interested in being the docs liaison for Nova?
nicolasbock at gmail.com
Thu Mar 2 12:07:02 UTC 2017
I'd be interested as well. Maybe Zhenyu and I could split this
role, although I am not a native English speaker either :)
On Wed, Mar 01, 2017 at 09:45:05AM -0600, Matt Riedemann wrote:
>There is a need for a liaison from Nova for the docs team to help with
>compute-specific docs in the install guide and various manuals.
>For example, we documented placement and cells v2 in the nova devref in
>Ocata but instructions on those aren't in the install guide, so the docs
>team is adding that here .
>I'm not entirely sure what the docs liaison role consists of, but I
>assume it at least means attending docs meetings, helping to review docs
>patches that are related to nova, helping to alert the docs team of big
>changes coming in a release that will impact the install guide, etc.
> From my point of view, I've historically pushed nova developers to be
>documenting new features within the nova devref since it was "closer to
>home" and could be tied to landing said feature in the nova tree, so
>there was more oversight on the docs actually happening *somewhere*
>rather than a promise to work them in the non-nova manuals, which a lot
>of the time was lip service and didn't actually happen once the feature
>was in. But there is still the need for the install guide as the first
>step to deploying nova so we need to balance both things.
>If no one else steps up for the docs liaison role, by default it lands
>on me, so I'd appreciate any help here.
More information about the OpenStack-dev