[OpenStack-docs] RST Based User Guides are published!

Meg McRoberts dreidellhasa at yahoo.com
Fri Apr 17 10:03:12 UTC 2015


The titles are clear enough.  What I don't understand is why the dark blue block at the top of the listsays "Icehouse".
When I'm looking at, say, the User Guide, I expected that choosing a different release from the drop-down menuwould give me the User Guide for that release.  I collected my thoughts and found that title in the list -- that's whyI suggested having the drop-down say, for example, "Juno documentation set" or have the header to the drop-downlist say something like "Documentation sets by release".

 
      From: Bernd Bausch <berndbausch at gmail.com>
 To: 'Andreas Jaeger' <aj at suse.com>; 'Meg McRoberts' <dreidellhasa at yahoo.com>; "'openstack-docs at lists.openstack.org'" <Openstack-docs at lists.openstack.org> 
 Sent: Friday, April 17, 2015 2:46 AM
 Subject: RE: [OpenStack-docs] RST Based User Guides are published!
   
> seems it's not obvious enough ;(

Same here. I figured it out eventually, but it wasn't immediately obvious. 



-----Original Message-----
From: Andreas Jaeger [mailto:aj at suse.com] 
Sent: Friday, April 17, 2015 6:35 PM
To: Meg McRoberts; openstack-docs at lists.openstack.org
Subject: Re: [OpenStack-docs] RST Based User Guides are published!

On 04/17/2015 10:28 AM, Meg McRoberts wrote:
> I like the look --  very nice!
>
> One thing I notice...  The text for both these guides says "This guide 
> documents OpenStack Kilo, OpenStack Juno, and OpenStack Icehouse
releases."
> But the top block of the left frame says "Icehouse...".  So I thought 
> maybe one could select a different release -- in this case, it would 
> display the same guide, but it might be set up for guides that have 
> different versions for different releases.
>
> However, when I click on "Juno", it takes me to 
> http://docs.openstack.org/juno/ -- I guess maybe that makes sense but 
> it surprised me.
>
> I'm thinking that the top block in the left frame should display the 
> latest release that is released, so to speak, and maybe the drop-downs 
> should say, for example, "Juno documentation" or maybe "RELEASES" in 
> the drop-down should said "Released doc sets" or something.

The block on the left is a quick Table of content for all guides - seems
it's not obvious enough ;( You should be able to jump from one guide quickly
to another with that block,

Andreas
--
  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
    GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,
        Graham Norton, HRB 21284 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126


_______________________________________________
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/20150417/2c0c57a1/attachment.html>


More information about the OpenStack-docs mailing list