[Openstack-docs] Questions regarding the degree of explanation in the openstack manuals

Matt Kassawara mkassawara at gmail.com
Thu Oct 2 14:18:17 UTC 2014


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.

On Thu, Oct 2, 2014 at 2:00 AM, Bas Peters <baspeters93 at gmail.com> wrote:

> Dear all,
>
>
>
> 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.
>
>
>
> 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?
>
>
> With kind regards,
>
>
>
> Bas
>
>
>
> PS. Anyone attending Linuxcon/Cloudopen Europe soon?
>
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20141002/77a40142/attachment.html>


More information about the Openstack-docs mailing list