<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Jun 1, 2015 at 8:19 AM, Thomas Goirand <span dir="ltr"><<a href="mailto:zigo@debian.org" target="_blank">zigo@debian.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi,<br>
<br>
tl;dr:<br>
- Please re-enable the install-guide generation for Debian so that it is<br>
possible to work on it and see an actual result<br>
- Please provide a list of actions to get the install-guide for Debian<br>
linked again on <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a><br>
- Let's get bugs filled better, as those who where opened were not<br>
actionable easily (multiple issues in a single bugs, and a single<br>
problem in multiple bugs: that's impossible to triage correctly)<br>
- I hope the docs team will be more welcoming and that the big-tent<br>
model also applies to the docs<br>
<br></blockquote><div><br></div><div>As I said at the Summit to you personally, we would like to get it reinstated. We need a plan and a backup. We are certainly welcoming and want to get the guide publishing again, but need a plan. Please participate or find someone to participate in: install guide team meetings, their spec review, and include Debian in the planning. </div><div><br></div><div>Thanks,</div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Longer version:<br>
<br>
As per the discussion I had with Lanna at the summit, I'd like that the<br>
Debian install-guide generation gets reactivated, so that at least, it<br>
is possible to work on the Debian install-guide and see the results.<br>
<br>
Then, the install-guide for Debian was removed mainly because of what<br>
Matt Kassawara wrote in this list, without cross-checking from anyone<br>
else, and because I was too busy on the Kilo release for Debian to pay<br>
enough attention to the doc list. Also, Alex (from Mirantis) was<br>
supposed to work on the Debian docs, but were assigned to something else<br>
by his managers, and he told nobody. So I had the feeling someone would<br>
take over the work, and left it aside.n<br>
<br>
The the Debian install guide was just removed without even saying under<br>
which conditions it would come back. There's currently no bugs open in<br>
Launchpad on that topic, it is hard to know what to work on.<br>
<br>
I am ok to do some actions, both on the packaging level and on the<br>
install-guide itself, to make it come back. However, for it to happen, I<br>
need to know what others feel isn't right.<br>
<br>
The bugs open by Matt, while sometimes containing accurate information,<br>
where hardly actionable because of the ways they were submitted. I hope<br>
that this wont happen again, so that all bugs can be actionable. I<br>
quickly told this to Matt at the summit. When a bug is open, it should<br>
contain a single issue only. And never twice an issue should be<br>
reported. This way, a bug can be triaged, fixed, or closed. I hope this<br>
simple guideline which everyone follows everywhere will also be observed<br>
on the docs bugs.<br>
<br>
In the absence of anyone opening new bugs of the Debian install-guide<br>
(and in a correct way this time), I would consider this means we all<br>
agree that both the Debian install-guide and its link on<br>
<a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a> should come back.<br>
<br>
Also, it is my understanding that the install-guide is currently being<br>
transitioned to RST format. Will this include the Kilo release? Is it<br>
worth for me to work on it? Is the RST guide located on a new<br>
repository, or is it taking over the old one? Please let me know so I<br>
know how to contribute.<br>
<br>
Last word: I've been on purpose quite about this issue, as I thought<br>
that letting time pass was the best option, to give a chance for brains<br>
to cool down (this includes myself...). However, I still have very hard<br>
feelings about what happened, and I strongly believe this was a<br>
non-welcoming action that isn't inline at all with the big tent model.<br>
It is my hope that core contributors (and the new PLT) also regret the<br>
course of actions, and that together, we'll fix it.<br>
<br>
Cheers,<br>
<br>
Thomas Goirand (zigo)<br>
<br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature">Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</div></div>