<div dir="ltr">What Matt says is all true, but specific to Ubuntu/MySQL, there is no other OpenStack install guide for that particular user. So I think that there tend to be more questions for Ubuntu and also more "beginners" or "freshers" reading that particular guide. RHEL has another install guide, SUSE has another install guide. Debian has no other guide to my knowledge either but we don't see as many comments there.<div><br></div><div>This is a nice analysis of the comments, for sure, thanks for looking at it and asking. We have a section in some books describing the audience and what their pre-requisite knowledge should be, for example:</div><div>Operations Guide: <a href="http://docs.openstack.org/openstack-ops/content/openstack-ops_preface.html#who-this-book-is-for">http://docs.openstack.org/openstack-ops/content/openstack-ops_preface.html#who-this-book-is-for</a></div><div><br></div><div>Security Guide: <a href="http://docs.openstack.org/security-guide/content/introduction-to-openstack.html">http://docs.openstack.org/security-guide/content/introduction-to-openstack.html</a></div><div><br></div><div>Architecture Design Guide: <a href="http://docs.openstack.org/arch-design/content/arch-guide-intended-audience.html">http://docs.openstack.org/arch-design/content/arch-guide-intended-audience.html</a></div><div><br></div><div>For the Install Guides, that audience analysis has been done many times in the past years, and we mostly come up with this type of statement: "This guide enables you to choose your own OpenStack adventure using a combination of basic and optional services." This statement gets various reactions but I think it's pretty close to truth: installing OpenStack is an adventure that many take, and we document it for a few happy paths with a lot of assumption about what people should know before going on the adventure. </div><div><br></div><div>Do you have suggestions for indicating that, perhaps with a section like the examples above?</div><div><br></div><div>Thanks,</div><div>Anne</div><div> </div></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Oct 2, 2014 at 9:18 AM, Matt Kassawara <span dir="ltr"><<a href="mailto:mkassawara@gmail.com" target="_blank">mkassawara@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">I hope most people installing OpenStack have at least a basic amount of Linux systems administration experience. However, after some previous banter on this topic, we still tend to provide the actual commands for steps requiring basic experience (e.g., symlinks). On the other hand, networking steps get tricky because most people installing OpenStack for the first time lack network administration experience, especially on Linux with bridges, iptables, namespaces, etc.</div><div class="gmail_extra"><br><div class="gmail_quote"><div><div class="h5">On Thu, Oct 2, 2014 at 2:00 AM, Bas Peters <span dir="ltr"><<a href="mailto:baspeters93@gmail.com" target="_blank">baspeters93@gmail.com</a>></span> wrote:<br></div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div class="h5"><div lang="NL" link="#0563C1" vlink="#954F72"><div><p class="MsoNormal">Dear all,<u></u><u></u></p><p class="MsoNormal"><u></u> <u></u></p><p class="MsoNormal"><span lang="EN-US">As I’m new to the openstack project, I’m having some problems regarding the degree of explanation required in the Openstack install guides. In Havana/Icehouse, there are a lot of questions by people on very elementary things anyone having worked with linux for some time at least semi-professionally should/would know. For instance, in the Havana release, most noticeably in the Ubuntu section for some reason, there are a lot of comments regarding the setting up of MySQL. A bit of Googling would be able to answer most of these questions, but in my opinion the reason they are asked in the first place is because it’s not clear to people just by reading the docs.<u></u><u></u></span></p><p class="MsoNormal"><span lang="EN-US"><u></u> <u></u></span></p><p class="MsoNormal"><span lang="EN-US">My question therefore is: To what degree should things be explained in the install guides? Is there a policy that I can find somewhere (I tried looking for it, but to no avail) regarding the depth of explanation? <u></u><u></u></span></p><p class="MsoNormal"><span lang="EN-US"><br>With kind regards,<span><font color="#888888"><u></u><u></u></font></span></span></p><span><font color="#888888"><p class="MsoNormal"><span lang="EN-US"><u></u> <u></u></span></p><p class="MsoNormal"><span lang="EN-US">Bas<u></u><u></u></span></p></font></span><p class="MsoNormal"><span lang="EN-US"><u></u> <u></u></span></p><p class="MsoNormal"><span lang="EN-US">PS. Anyone attending Linuxcon/Cloudopen Europe soon?<u></u><u></u></span></p></div></div><br></div></div>_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></blockquote></div><br></div>
<br>_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></blockquote></div><br></div>