[OpenStack-docs] [User Guides] Reorganize User Guides Spec for Mitaka.

Joseph Robinson joseph.robinson at RACKSPACE.COM
Fri Oct 23 06:10:32 UTC 2015


Hello all,

For the M summit next week, I've put together a spec for reorganising the User Guides for the M release with the User Guides Team.

https://review.openstack.org/#/c/238770/

On some of the Proposed Changes:

I raised number of files in the repository as a proposed change for visual reasons - file number has no effect on the build, but my thoughts are that smaller repos might make the guide easier to search and handle. This idea spun out of User Guide team talks during the conversion to .rst format.

Conditionals was an (slightly naïve) idea I had for combining the guides together. A point for discussion here to eventually improve or change the docs spec - Should the User Guides be reorganised to have conditionals?

Best Regards,

Joseph Robinson
Information Developer I
 -------------------------------
Joseph.Robinson at Rackspace.com



________________________________
Rackspace Hosting Australia PTY LTD a company registered in the state of Victoria, Australia (company registered number ACN 153 275 524) whose registered office is at Level 1, 37 Pitt Street, Sydney, NSW 2000, Australia. Rackspace Hosting Australia PTY LTD privacy policy can be viewed at www.rackspace.com.au/company/legal-privacy-statement.php - This e-mail message may contain confidential or privileged information intended for the recipient. Any dissemination, distribution or copying of the enclosed material is prohibited. If you receive this transmission in error, please notify us immediately by e-mail at abuse at rackspace.com and delete the original message. Your cooperation is appreciated.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20151023/ae9d2bd2/attachment.html>


More information about the OpenStack-docs mailing list