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

[Doug Hellmann]

Excerpts from Doug Hellmann's message of 2017-08-01 15:35:35 -0400:
> 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.
> 
> Doug
> 

If you want an idea of the sorts of work ahead, check out the tracking
pad: https://etherpad.openstack.org/p/doc-future-problems

Not everything on that list is related to the tools, but quite a lot is.

Doug

__
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

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

[Doug Hellmann]

Excerpts from Swapnil Kulkarni's message of 2017-08-02 14:35:49 +0530:
> On Wed, Aug 2, 2017 at 2:25 PM, Bogdan Dobrelya  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-requ...@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-requ...@lists.openstack.org?subject:unsubscribe
> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
> 
> 
> +1
> 

Thanks, Bogdan and Swapnil, I'm happy to have you on board!

Doug

__
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

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

[Swapnil Kulkarni]

On Wed, Aug 2, 2017 at 2:25 PM, Bogdan Dobrelya  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-requ...@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-requ...@lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


+1

__
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

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

[Bogdan Dobrelya]

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-requ...@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-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev