Open Stack

I don't personally love the scrolling bars but they are sometimes necessary...
It would be nice if it were possible to reduce the point size for a table or a long commandline -- often that is enough.
And the markup guide should specify the max number of characters that can be displayedwith the current tools.  It seems that RST formats tables to fit but, for command lines, onecan always put a \ at the end of first lines so the text is continued on a second line, anddefine how we format it -- I prefer that the "continuation" lines be indented a few spacesso one sees at a glance that it is not a free-standing second command.
I noticed that the RST tables are a little dull -- it would be nice if the headers were formatteddifferently than the rest of the table.
meg

 
      From: Karen Bradshaw <kbhawkey at gmail.com>
 To: "openstack-docs at lists.openstack.org" <OpenStack-docs at lists.openstack.org> 
 Sent: Monday, June 8, 2015 8:12 AM
 Subject: [OpenStack-docs] formatting, styling of RST content
   
Hi.  I am wondering if anyone is thinking about or working onstyling tables or python/curl script output for the RST docs. I noticed the install guide contains a number of scrolling areas.The docs generated from DocBook provide scrolling of content for long curl commands or tables that do not necessarily fit in the specified margin.  
What do you think about adding scrolling to control big tables and large string commands? Is it possible to change the stylesheets/theme to permit scrolling or write a Sphinx extension to help with the table formatting?Are there other areas to look at for improving navigation, formatting of RST content?
Thanks.
-Karen 
-----------------------------Karen Bradshawkbhawkey at gmail.com

_______________________________________________
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/20150608/b782c7a0/attachment.html>