osdir.com


[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[all] [tc] [docs] [release] [ptls] Docs as SIG: Ownership of docs.openstack.org



> On Aug 19, 2019, at 11:41 AM, Sean McGinnis <sean.mcginnis at gmx.com> wrote:
> 
>> 
>> Quick recap: The documentation team is set to disband as an official
>> project, and make the leap to becoming a SIG (Special Interest Group).
>> 
>> 
>> The remaining individuals working on the docs team are sorting through
>> what's left and where it is best placed. In [1], Doug has rightfully
>> pointed out that whilst the documentation team as it stands today is no
>> longer "integral", the docs.openstack.org web site is. An owner is
>> required.
>> 
> 
> Unless things have changed, SIGs can be owners of a resource published via
> docs.openstack.org (and I am assuming that means be extension, docs.o.o
> itself). Is there a reason the Docs SIG would not still be able to own the
> site?
> 
>> The suggestion is for the Release Management team is the "least worst"
>> (thanks, tonyb) place for the website manaagement to land. As Tony
>> points out, this requires learning new tools and processes but the
>> individuals working on the docs team currently have no intention to
>> leave, and are around to help manage this from the SIG.
>> 
> 
> I'm personally fine with the release team taking this on, but it does seem like
> an odd fit. I think it would make a lot more sense for the Docs SIG to own the
> docs site than the release team.

Thierry has always drawn (one of) the distinction(s) between teams and SIGs as
being that teams own tasks that are â??part ofâ?? the thing we produce that we call
OpenStack, while SIGs are less formally part of that input to that production process.

Updating the docs site every time we have a new release felt like it should
be part of the formal process, and definitely not something we should leave to 
chance. The cadence made me think the release team could be a good home.

Itâ??s 95% automated now, for what thatâ??s worth. I imagine someone could automate the step of
adding the new series pages, although Iâ??m not sure what the trigger would be.

We could also look at other ways to build the site that donâ??t require any action
each cycle, of course, including not updating it at all and only publishing docs
out of master. Thatâ??s especially appealing if we donâ??t have anyone in the
community willing and able to pick up the work.

> 
>> Open to discussion and suggestions, but to summarise the proposal here:
>> 
>> docs.openstack.org ownership is to transition to be the responsibility
>> of the Release Management team officially provided there are no strong
>> objections.
>> 
>> Thanks,
>> 
>> Alex
>> IRC: asettle
>> 
>> [1] https://review.opendev.org/#/c/657142/
>> [2] https://review.opendev.org/#/c/657141/
>