Open Stack

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

On 12/10/15 21:43, Olga Gusarenko wrote:
> Hi all,
> 
> The Contributor guide is almost ready to be published.
> 
> We have several commits on review at the moment. They are:
> 
>    - https://review.openstack.org/#/c/232966/
>    - https://review.openstack.org/#/c/233183/
>    - some information from the HowTo conventions page will be available on
>    review in a day.
> 
> *Your reviews are welcome.*
> Therefore, we would like to know the next steps to take to have the guide
> published.
> 
>>> *Andreas suggests the following solutions*:
>>> On a technical level: Update tools/build-all-rst.sh so that it does not
> get published at /draft/ and update all index.html pages.
>>> On a process level: Once those changes are in, I suggest we do a one
> week review of the content (still as draft) and afterwards to the technical
> change.
>>> We do not need to wait for Liberty, we can publish and announce anytime
> we think we're ready.

+1

> 
> Another question is about DocBook markup. I suggest leaving the related
> conventions as they are (on wiki), and create a separate page in the
> Contributor guide with the information that the DocBook markup is
> deprecated at the moment but if users need it they can refer to
> https://wiki.openstack.org/wiki/Documentation/Markup_conventions.
> What do you think?
> 
>>> *from Andreas*:
>>> Works for me.
> 

Docbook isn't entirely deprecated, we still have books using it. So I agree with leaving it on the wiki and putting a pointer to it in the Guide, but maybe just say that we are in the process of moving away from Docbook, rather than calling it deprecated.

> *Your thoughts and ideas regarding the matter are very much appreciated!*

Thank you for working on this! Looking forward to getting it published :)

L

- -- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBCAAGBQJWG6O3AAoJELppzVb4+KUyI4IIALm2Lv6kyDaBCMx6zeUWU+UY
7sy7hlpVkVbNpYihRc5T7RH4yJ4Bva7q8GDAVf0FgRwLOlZJ/8S/+RF8U7skqlm2
G5GQvzPQNpOm+JUL9P4YzhbNAtZwNLv3phpX12iKgW8G34QyV6ATABt0Hw0BXoKb
9BXNMyOVoJUHOll1LbdgLvKz12pMRd3ud/ymMDd7mIJOFT9yopopOy3WnICz7J3n
obJQMgkiqaG5EO2H7FzDS8S7xjSHLSEBWX95SbeS6FQ8RhV77UyU9jujAaLd1C1h
m33SOsmWzmJ66mWK3jpOyOhQTRcIfz3ufP0wAgRWSbOLW4uAWTbvs+d7Bf0neFA=
=SJZn
-----END PGP SIGNATURE-----