<div dir="ltr">Hi Atul:<br><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Feb 6, 2013 at 2:59 AM, Atul Jha <span dir="ltr"><<a href="mailto:Atul.Jha@csscorp.com" target="_blank">Atul.Jha@csscorp.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi All,<br>
<br>
I had a suggestion and wanted to put forward.<br>
<br>
Currently our complete doc structure looks like this<br>
<br>
Installing OS<br>
       -- Contains install information on Ubuntu and Fedora<br>
Running OS<br>
       -- Contains concepts about OS components and install steps as well for Debian/Suse/Ubunu/Fedora to some extent<br>
Developing OS<br>
OS CLI<br>
OS API<br>
Glossary<br>
<br>
<br>
Will it be good idea to restructure Running OS and Installing OS this way<br>
<br>
Installing OS<br>
    -- On Ubuntu<br>
          -- Basic<br>
          -- Advanced<br>
<br>
    -- On Redhat/Centos/Fedora<br>
          -- Basic<br>
          -- Advanced<br>
   -- On Other OS<br>
          -- Basic<br>
          -- Advance<br>
<br>
Too an extent its already existing, my real concern is with the  "Running OS" part which has overlapping contents as in install instructions.<br>
<br>
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.<br>

<br>
Compute administration guide<br>
       -- Concept of nova<br>
       -- Architecture<br>
       -- Hypervisor based config change<br>
       -- Available config flags<br>
<br>
<br>
What do you guys think?<br></blockquote></div><div><br></div><div style>Can you give an example of some content that currently is in the compute admin guide that you think shouldn't be there because of the overlap with the installation manuals?</div>
<div style><br></div><div style>I'm not opposed to a refactor on principle, but I also worry about users needing to jump around across many different manuals, because the current task they are trying to perform cuts across multiple doc guides. I think some content overlap might be unavoidable. If you could provide some specific examples about content that you recommend be removed from the admin guide, it would help me understand this better.</div>
<div style><br></div><div style>Take care,</div><div style><br></div><div style>Lorin</div><div><br></div>-- <br><div dir="ltr">Lorin Hochstein<br><div>Lead Architect - Cloud Services</div><div>Nimbis Services, Inc.</div>
<div><a href="http://www.nimbisservices.com" target="_blank">www.nimbisservices.com</a></div></div>
</div></div>