[openstack-dev] [all][docs] recruiting for help with documentation tools

Swapnil Kulkarni coolsvap at gmail.com
Wed Aug 2 09:05:49 UTC 2017


On Wed, Aug 2, 2017 at 2:25 PM, Bogdan Dobrelya <bdobreli at redhat.com> wrote:
> On 01.08.2017 21:35, Doug Hellmann wrote:
>> With the changes we've made to docs processes upstream, every team
>> is going to need to build up their knowledge of how the new
>> documentation tools and jobs work. The docs team will still help,
>> but things will obviously go more smoothly if folks know how the
>> tools work, now that the bulk of the content is in-tree with the
>> code.
>>
>> At the same time, the docs team could use help with developing and
>> maintaining those tools. We have a couple people working on them
>> now (me, Andreas, and Anne), but none of us is doing it full time.
>> I need to transition off of this work, so over the course of Queens
>> I will be trying to build up the skills of the existing team so
>> they do not need to rely on me so much. Also, Andreas and Anne have
>> said that they cannot commit to driving any work.
>>
>> Although the documentation team has some skills in this area, they
>> could use help, so I would like to find a few people to join the
>> team specifically to work on the tooling (although if you wanted
>> to write documentation, too, no one will object).
>>
>> Some of you have been helping informally (thank you!), but the
>> community shift is big enough that we need to account for the new
>> need a bit more formally. I think if we could find several people
>> who could give a small percentage of their time (10%?), we would
>> be well covered. There will not be work every week, but when there
>> is something to do it's likely to take a small extended period (1-2
>> days) to add a feature or resolve an issue. If we found 4-6 people,
>> I think we would be covered and have a sustainable group.
>>
>> The areas we need help are maintaining the doc build jobs, the
>> sphinx extensions in oslo.config and oslo.policy, the Sphinx theme,
>> and the template build tool in the openstack-manuals git repo. These
>> are all minimally complete, but there is definitely feature work
>> and bug fixing to do. I can guarantee that, if you sign up to help,
>> you will have a chance to land changes that will be visible for all
>> OpenStack users. At the start of Queens, I will be doing some
>> one-on-one training with volunteers to ensure they understand the
>> system we have in place now and help them start on some of the
>> remaining feature work.
>>
>> If you are interested in helping, please let me know by following
>> up to this thread, and then join #openstack-docs on IRC.
>
> +1
>
>>
>> Doug
>>
>> __________________________________________________________________________
>> OpenStack Development Mailing List (not for usage questions)
>> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>>
>
>
> --
> Best regards,
> Bogdan Dobrelya,
> Irc #bogdando
>
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


+1



More information about the OpenStack-dev mailing list