On Aug 19, 2019, at 11:41 AM, Sean McGinnis <sean.mcginnis@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/