[Openstack-docs] Restructuring OpenStack-doc for Grizzly
Atul Jha
Atul.Jha at csscorp.com
Wed Feb 6 07:59:30 UTC 2013
Hi All,
I had a suggestion and wanted to put forward.
Currently our complete doc structure looks like this
Installing OS
-- Contains install information on Ubuntu and Fedora
Running OS
-- Contains concepts about OS components and install steps as well for Debian/Suse/Ubunu/Fedora to some extent
Developing OS
OS CLI
OS API
Glossary
Will it be good idea to restructure Running OS and Installing OS this way
Installing OS
-- On Ubuntu
-- Basic
-- Advanced
-- On Redhat/Centos/Fedora
-- Basic
-- Advanced
-- On Other OS
-- Basic
-- Advance
Too an extent its already existing, my real concern is with the "Running OS" part which has overlapping contents as in install instructions.
Keeping Nova/Swift/Quantum guide with conf files and basic concepts behind it and updating it on regular basis will be much better. Lets take compute admin guide for example. I find it like having too much data and to an extent replication of our Install OS components in it.
Compute administration guide
-- Concept of nova
-- Architecture
-- Hypervisor based config change
-- Available config flags
What do you guys think?
Thanks!!
Atul Jha
@koolhead17
http://www.csscorp.com/common/email-disclaimer.php
More information about the Openstack-docs
mailing list