[Openstack-docs] Feature request: Handling multiple linux flavours, versions etc.

kesten broughton kesten.broughton at gmail.com
Thu Sep 12 12:34:04 UTC 2013


Currently, openstack docs support ubuntu and (sometimes) centos.  google
search often turns up folsom or grizzly pages.

I'm wondering if the doc system for openstack would allow a nice tab
switching between linux flavors and versions (folsom, griz, havanna)
similar to this

http://wiki.blender.org/index.php/Doc:2.6/Manual/3D_interaction

Notice the top drop down tab to switch between version number, and language.

Though the os documentation is currently manageable, what if you were to
add a new linux flavor (say SUSE) or major differences between versions
(havanna).  Having all the options together in a page makes it cluttered.

Some examples:
multiple linux flavors in the same doc.
http://docs.openstack.org/trunk/openstack-image/content/ch_obtaining_images.html

ubuntu only (will cause lots of not-really-bug-reports for centos users)
http://docs.openstack.org/trunk/openstack-compute/install/apt/content/assumptions.html

Another problem some wiki docs encounter is that upon a new release, the
new documentation has low page rank compared to the previous, so top hits
are outdated.  The tab-switch solves this, and allows
same-themed-newer-version-page  to "share" the high rank of old page.

Since many openstack doc pages are uni-sex (same for any flavor or version)
the other options could be greyed out if unavailable.

kesten
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130912/cd901f51/attachment.html>


More information about the Openstack-docs mailing list