Open Stack

Hi Thomas,

To answer what I can:

- The RST conversion is for Liberty going forward; the Kilo guide will
remain in DocBook. I've added a section for it on the Migration page.[1]

- There's a WIP blueprint[2] and spec[3] for the Liberty install guide;
comments and input are welcome. Is the level of work involved in updating
the Debian guide and converting it to RST such that it would be useful to
develop a separate spec for the Debian guide? I don't have a lot of
familiarity with the guide, but my impression is that significant work
will be involved in updating and testing it. Perhaps a spec would be a
useful way of collecting and organizing a to-do list of what needs to be
done.

- The installation guide specialty team has a weekly meeting, and the info
can be found on the team page. Any contributors are welcome.[4]


[1] 
https://wiki.openstack.org/wiki/Documentation/Migrate#Installation_Guide_Mi
gration
[2] 
https://blueprints.launchpad.net/openstack-manuals/+spec/installguide-liber
ty
[3] https://review.openstack.org/#/c/183138/
[4] https://wiki.openstack.org/wiki/Documentation/InstallGuide



On 6/1/15, 8:19 AM, "Thomas Goirand" <zigo at debian.org> wrote:

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