Hi!

Anyone who is happy to help out with the liaison role, I am happy to work 
alongside them and ensure they are pointed in the right direction.

As Matt said, the position 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.

We don’t need someone to help correct our writing, we need a technical ‘expert’ 
:)

Alex

From: Zhenyu Zheng <zhengzhenyul...@gmail.com>
Reply-To: "OpenStack Development Mailing List (not for usage questions)" 
<openstack-dev@lists.openstack.org>
Date: Thursday, March 2, 2017 at 1:22 AM
To: "OpenStack Development Mailing List (not for usage questions)" 
<openstack-dev@lists.openstack.org>
Subject: Re: [openstack-dev] [nova][docs] Is anyone interested in being the 
docs liaison for Nova?

Hi,

I'm not a native English speaker but I would like to have a try if possible :)

On Wed, Mar 1, 2017 at 11:45 PM, Matt Riedemann 
<mriede...@gmail.com<mailto:mriede...@gmail.com>> 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 [1].

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.

[1] https://review.openstack.org/#/c/438328/

--

Thanks,

Matt Riedemann

__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: 
openstack-dev-requ...@lists.openstack.org?subject:unsubscribe<http://openstack-dev-requ...@lists.openstack.org?subject:unsubscribe>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Reply via email to