<div dir="ltr">I think a great model we have in general as a community is if people show up to do the work, it is not something crazy, get out of their way; at least that is how I think of it. I apologize if there is any perception opposed to my previous statement by me bringing up the other repos. I tried to be clear in wanting to get feedback from Doug in hope that as we move forward in general, what are some thoughts on that front to ensure we continue to remove roadblocks if any exist in parallel to great work, like what Chris is driving here. On that front, please do what works best for those doing the work.<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, May 24, 2018 at 7:26 AM, Jonathan D. Proulx <span dir="ltr"><<a href="mailto:jon@csail.mit.edu" target="_blank">jon@csail.mit.edu</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On Thu, May 24, 2018 at 07:07:10AM -0700, Doug Hellmann wrote:<br>
<br>
:I know you wanted to avoid lots of governance overhead, so I want<br>
<span class="">:to just mention that establishing a SIG is meant to be a painless<br>
:and light-weight way to declare that a group of interested people<br>
:exists so that others can find them and participate in the work<br>
:[1]. It shouldn't take much effort to do the setup, and any ongoing<br>
:communication is something you would presumably by doing anyway<br>
:among a group of people trying to collaborate on a project like<br>
:this.<br>
<br>
</span>Yeah I can see SIG as a useful structure too.  I'm just more familiar<br>
with UC "teams" because of my personal history.<br>
<br>
I do thing SIG -vs- team would impace repo naming, and I'm still going<br>
over creation doc, so I'll let this simmer here at least until YVR lunch<br>
time to see if there's consensus or cotroversy in the potential<br>
contributer community.  Lacking either I think I will default to<br>
SIG-ops-docs.<br>
<br>
Thanks,<br>
-Jon<br>
<br>
:<br>
:Let me know if you have any questions or concerns about the process.<br>
<div class="HOEnZb"><div class="h5">:<br>
:Doug<br>
:<br>
:[1] <a href="https://governance.openstack.org/sigs/#process-to-create-a-sig" rel="noreferrer" target="_blank">https://governance.openstack.<wbr>org/sigs/#process-to-create-a-<wbr>sig</a><br>
:<br>
:> <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>
:> 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>
:> <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>
<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"><br>-- <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>