<div dir="ltr">Hello!<div><p style="margin:0in;font-family:Calibri;font-size:11pt"><span lang="en-SI">I
promised to prepare my view as a user of kolla-ansible on its documentation.
</span><span lang="en-US">In my opinion the division between admin guides
and user guides is artificial, as the user of kolla-ansible is actually the
cloud administrator. </span></p><p style="margin:0in;font-family:Calibri;font-size:11pt"><span lang="en-US">Maybe it would be good to think about reorganizing
the structure of documentation. Many good chapters are already written, they only have
to be positioned in the right place to be found more easily.</span></p>

<p style="margin:0in;font-family:Calibri;font-size:11pt"><span lang="en-SI">So
h</span><span lang="en-US">ere is my proposal</span><span lang="en-SI"> of
kolla-ansible doc's structure</span><span lang="en-US">:</span></p><p style="margin:0in;font-family:Calibri;font-size:11pt"><span lang="en-US">1. Introduction<br>1.1.      mission<br>1.2.   benefits<br>1.3.  support matrix<br>2.      Architecture<br>2.1.      basic architecture<br>2.2.        HA architecture<br>2.3.   network architecture<br>2.4.      storage architecture<br>3.        Workflows<br>3.1. preparing the surroundings (networking, docker registry, ...)<br>3.2.     preparing servers (packages installation)<br>3.3. configuration (of kolla-ansible and description of basic logic for configuration of Openstack modules)<br>3.4.    1st day procedures (bootstrap, deploy, destroy)<br>3.5.   2nd day procedures (reconfigure, upgrade, add, remove nodes ...)<br>3.6.  multiple regions<br>3.7.  multiple cloud<br>3.8.    security<br>3.9.  troubleshooting (how to check, if cloud works, what to do, if it doesn't)<br>4.       Use Cases<br>4.1. all-in-one<br>4.2.        basic vm multinode<br>4.3.        some production use cases<br>5.   Reference guide<br>Mostly the same structure as already is. Except it would be desirable that description of each module has:<br>-  purpose of the module<br>-        configuration of the module<br>-  how to use it with links to module docs<br>-      basic troubleshooting<br>6.       Contributor guide</span></p><p style="margin:0in;font-family:Calibri;font-size:11pt"><span lang="en-US"><br></span></p><p class="MsoNormal" style="margin:0cm 0cm 0.0001pt 27pt;line-height:normal;vertical-align:middle;font-size:11pt;font-family:Calibri,sans-serif"><span lang="SL"></span></p><p style="margin:0in;font-family:Calibri;font-size:11pt"><span lang="en-SI">The documentation also needs
figures, pictures, diagrams to be more understandable.  So at least in the first chapters some of them
shall be added.</span></p><p style="margin:0in;font-family:Calibri;font-size:11pt" lang="en-SI"><br></p><p style="margin:0in;font-family:Calibri;font-size:11pt" lang="en-SI">I'm also
thinking about convergence of documentation of kayobe, kolla and kolla-ansible
projects. It's true that there's no strict connection between kayobe and other
two and kolla containers can be used without kolla-ansible playbooks. But the
real benefit the user can get is to use all three projects together. But let's
leave that for the second phase.</p><p style="margin:0in;font-family:Calibri;font-size:11pt" lang="en-US"> </p><p style="margin:0in;font-family:Calibri;font-size:11pt"><span lang="en-SI">



</span></p><p style="margin:0in;font-family:Calibri;font-size:11pt" lang="en-SI">So please
comment on this proposal. Do you think it's going in the right direction? If yes,
I can refine it. </p><p style="margin:0in;font-family:Calibri;font-size:11pt"><span lang="en-SI"><br></span></p></div></div>