[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