<div dir="ltr">Great to see this moving. I have some questions/concerns based on your statement Doug about <a href="http://docs.openstack.org">docs.openstack.org</a> publishing and do not want to detour the conversation but ask for feedback. Currently there are a number of repositories under osops-<div><br></div><div><a href="https://github.com/openstack-infra/project-config/blob/master/gerrit/projects.yaml#L5673-L5703">https://github.com/openstack-infra/project-config/blob/master/gerrit/projects.yaml#L5673-L5703</a><br></div><div><br></div><div>Generally active:</div><div>osops-tools-contrib</div><div>osops-tools-generic</div><div>osops-tools-monitoring</div><div><br></div><div><br></div><div>Probably dead:</div><div>osops-tools-logging</div><div>osops-coda</div><div>osops-example-configs</div><div><br></div><div>Because you are more familiar with how things work, is there a way to consolidate these vs coming up with another repo like osops-docs or whatever in this case? And second, is there already governance clearance to publish based on the following - <a href="https://launchpad.net/osops">https://launchpad.net/osops</a> - which is where these repos originated.</div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, May 23, 2018 at 9:56 PM, Frank Kloeker <span dir="ltr"><<a href="mailto:eumel@arcor.de" target="_blank">eumel@arcor.de</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi Chris,<br>
<br>
thanks for summarize our session today in Vancouver. As I18n PTL and one of the Docs Core I put Petr in Cc. He is currently Docs PTL, but unfortunatelly not on-site.<br>
I couldn't also not get the full history of the story and that's also not the idea to starting finger pointing. As usualy we moving forward and there are some interesting things to know what happened.<br>
First of all: There are no "Docs-Team" anymore. If you look at [1] there are mostly part-time contributors like me or people are more involved in other projects and therefore busy. Because of that, the responsibility of documentation content are moved completely to the project teams. Each repo has a user guide, admin guide, deployment guide, and so on. The small Documentation Team provides only tooling and give advices how to write and publish a document. So it's up to you to re-use the old repo on [2] or setup a new one. I would recommend to use the best of both worlds. There are a very good toolset in place for testing and publishing documents. There are also various text editors for rst extensions available, like in vim, notepad++ or also online services. I understand the concerns and when people are sad because their patches are ignored for months. But it's 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 OpenStack Operations Guide is available in different languages and portable in different formats like in Sphinx. For us as translation team it's a good possibility to get feedback about the quality and to understand the 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/o<wbr>perations-guide</a><div><div class="h5"><br>
<br>
Am 2018-05-24 03:38, schrieb Chris Morgan:<br>
</div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div class="h5">
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.org<wbr>/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" target="_blank">mihalis68@gmail.com</a>><br></div></div><span class="">
______________________________<wbr>_________________<br>
OpenStack-operators mailing list<br>
<a href="mailto:OpenStack-operators@lists.openstack.org" target="_blank">OpenStack-operators@lists.open<wbr>stack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi<wbr>-bin/mailman/listinfo/openstac<wbr>k-operators</a><br>
</span></blockquote><div class="HOEnZb"><div class="h5">
<br>
<br>
______________________________<wbr>_________________<br>
OpenStack-operators mailing list<br>
<a href="mailto:OpenStack-operators@lists.openstack.org" target="_blank">OpenStack-operators@lists.open<wbr>stack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi<wbr>-bin/mailman/listinfo/openstac<wbr>k-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>