<div dir="ltr">Sure definitely, that's why I said I was not trying to detour the conversation, but rather asking for feedback. Definitely agree things should continue to plow forward and Chris has been doing an excellent job here and I think it is awesome that he is continuing to push this.</div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, May 23, 2018 at 10:58 PM, Doug Hellmann <span dir="ltr"><<a href="mailto:doug@doughellmann.com" target="_blank">doug@doughellmann.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Excerpts from Melvin Hillsman's message of 2018-05-23 22:26:02 -0700:<br>
<span class="">> Great to see this moving. I have some questions/concerns based on your<br>
> statement Doug about <a href="http://docs.openstack.org" rel="noreferrer" target="_blank">docs.openstack.org</a> publishing and do not want to<br>
> detour the conversation but ask for feedback. Currently there are a number<br>
<br>
</span>I'm just unclear on that, but don't consider it a blocker. We will sort<br>
out whatever governance or policy change is needed to let this move<br>
forward.<br>
<span class=""><br>
> of repositories under osops-<br>
> <br>
> <a href="https://github.com/openstack-infra/project-config/blob/master/gerrit/projects.yaml#L5673-L5703" rel="noreferrer" target="_blank">https://github.com/openstack-<wbr>infra/project-config/blob/<wbr>master/gerrit/projects.yaml#<wbr>L5673-L5703</a><br>
> <br>
> Generally active:<br>
> osops-tools-contrib<br>
> osops-tools-generic<br>
> osops-tools-monitoring<br>
> <br>
> <br>
> Probably dead:<br>
> osops-tools-logging<br>
> osops-coda<br>
> osops-example-configs<br>
> <br>
> Because you are more familiar with how things work, is there a way to<br>
> consolidate these vs coming up with another repo like osops-docs or<br>
> whatever in this case? And second, is there already governance clearance to<br>
> publish based on the following - <a href="https://launchpad.net/osops" rel="noreferrer" target="_blank">https://launchpad.net/osops</a> - which is<br>
> where these repos originated.<br>
<br>
</span>I don't really know what any of those things are, or whether it<br>
makes sense to put this new content there. I assumed we would make<br>
a repo with a name like "operations-guide", but that's up to Chris<br>
and John.  If they think reusing an existing repository makes sense,<br>
that would be OK with me, but it's cheap and easy to set up a new<br>
one, too.<br>
<br>
My main concern is that we remove the road blocks, now that we have<br>
people interested in contributing to this documentation.<br>
<div class="HOEnZb"><div class="h5"><br>
> <br>
> On Wed, May 23, 2018 at 9:56 PM, Frank Kloeker <<a href="mailto:eumel@arcor.de">eumel@arcor.de</a>> wrote:<br>
> <br>
> > Hi Chris,<br>
> ><br>
> > thanks for summarize our session today in Vancouver. As I18n PTL and one<br>
> > of the Docs Core I put Petr in Cc. He is currently Docs PTL, but<br>
> > unfortunatelly not on-site.<br>
> > I couldn't also not get the full history of the story and that's also not<br>
> > the idea to starting finger pointing. As usualy we moving forward and there<br>
> > are some interesting things to know what happened.<br>
> > First of all: There are no "Docs-Team" anymore. If you look at [1] there<br>
> > are mostly part-time contributors like me or people are more involved in<br>
> > other projects and therefore busy. Because of that, the responsibility of<br>
> > documentation content are moved completely to the project teams. Each repo<br>
> > has a user guide, admin guide, deployment guide, and so on. The small<br>
> > Documentation Team provides only tooling and give advices how to write and<br>
> > publish a document. So it's up to you to re-use the old repo on [2] or<br>
> > setup a new one. I would recommend to use the best of both worlds. There<br>
> > are a very good toolset in place for testing and publishing documents.<br>
> > There are also various text editors for rst extensions available, like in<br>
> > vim, notepad++ or also online services. I understand the concerns and when<br>
> > people are sad because their patches are ignored for months. But it's<br>
> > alltime a question of responsibilty and how can spend people time.<br>
> > I would be available for help. As I18n PTL I could imagine that a<br>
> > OpenStack Operations Guide is available in different languages and portable<br>
> > in different formats like in Sphinx. For us as translation team it's a good<br>
> > possibility to get feedback about the quality and to understand the<br>
> > requirements, also for other documents.<br>
> > So let's move on.<br>
> ><br>
> > kind regards<br>
> ><br>
> > Frank<br>
> ><br>
> > [1] <a href="https://review.openstack.org/#/admin/groups/30,members" rel="noreferrer" target="_blank">https://review.openstack.org/#<wbr>/admin/groups/30,members</a><br>
> > [2] <a href="https://github.com/openstack/operations-guide" rel="noreferrer" target="_blank">https://github.com/openstack/<wbr>operations-guide</a><br>
> ><br>
> ><br>
> > Am 2018-05-24 03:38, schrieb Chris Morgan:<br>
> ><br>
> >> Hello Everyone,<br>
> >><br>
> >> In the Ops Community documentation working session today in Vancouver,<br>
> >> we made some really good progress (etherpad here:<br>
> >> <a href="https://etherpad.openstack.org/p/YVR-Ops-Community-Docs" rel="noreferrer" target="_blank">https://etherpad.openstack.<wbr>org/p/YVR-Ops-Community-Docs</a> but not all of<br>
> >> the good stuff is yet written down).<br>
> >><br>
> >> In short, we're going to course correct on maintaining the Operators<br>
> >> Guide, the HA Guide and Architecture Guide, not edit-in-place via the<br>
> >> wiki and instead try still maintaining them as code, but with a<br>
> >> different, new set of owners, possibly in a new Ops-focused repo.<br>
> >> There was a strong consensus that a) code workflow >> wiki workflow<br>
> >> and that b) openstack core docs tools are just fine.<br>
> >><br>
> >> There is a lot still to be decided on how where and when, but we do<br>
> >> have an offer of a rewrite of the HA Guide, as long as the changes<br>
> >> will be allowed to actually land, so we expect to actually start<br>
> >> showing some progress.<br>
> >><br>
> >> At the end of the session, people wanted to know how to follow along<br>
> >> as various people work out how to do this... and so for now that place<br>
> >> is this very email thread. The idea is if the code for those documents<br>
> >> goes to live in a different repo, or if new contributors turn up, or<br>
> >> if a new version we will announce/discuss it here until such time as<br>
> >> we have a better home for this initiative.<br>
> >><br>
> >> Cheers<br>
> >><br>
> >> Chris<br>
> >><br>
> >> --<br>
> >> Chris Morgan <<a href="mailto:mihalis68@gmail.com">mihalis68@gmail.com</a>><br>
> >> ______________________________<wbr>_________________<br>
> >> OpenStack-operators mailing list<br>
> >> <a href="mailto:OpenStack-operators@lists.openstack.org">OpenStack-operators@lists.<wbr>openstack.org</a><br>
> >> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-operators</a><br>
> >><br>
> ><br>
> ><br>
> > ______________________________<wbr>_________________<br>
> > OpenStack-operators mailing list<br>
> > <a href="mailto:OpenStack-operators@lists.openstack.org">OpenStack-operators@lists.<wbr>openstack.org</a><br>
> > <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-operators</a><br>
> ><br>
> <br>
<br>
______________________________<wbr>_________________<br>
OpenStack-operators mailing list<br>
<a href="mailto:OpenStack-operators@lists.openstack.org">OpenStack-operators@lists.<wbr>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-operators</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div style="font-size:small"><div dir="ltr"><div dir="ltr">Kind regards,<br><br>Melvin Hillsman</div><div dir="ltr"><a href="mailto:mrhillsman@gmail.com" style="color:rgb(17,85,204)" target="_blank">mrhillsman@gmail.com</a><br>mobile: (832) 264-2646<br></div></div></div></div></div></div></div></div></div>
</div>