Am 11.10.2010 19:47 schrieb Michael Pedersen:
First, I'm setting the date for the doc sprint as Oct 30. The time
I'll be starting is 10am, eastern time (3pm GMT). Plan is for me to be
online/available until at least 6pm eastern (11pm GMT).
I've already put it in my calendar.
One of my long term goals is to provide three versions of the docs:
HTML, PDF, and ePub.
Which will not be so hard since it's supported by RST/Sphinx.
You can have a sticky sidebar with the Sphinx default template by setting
the stickysidebar option. Unfortunately, there is no such option for the top
and bottom bars, so the top links and bread crumbs move away when scrolling.
Not good. Seens very few docs have sticky navigation, maybe because of
compatibility issues with various browsers. We would probably need to invent
something on our own.
My only object to having more floating sections is real estate. As it
stands, we're going to have something on the side, taking up screen
space. If we add something sticky to the top and/or bottom, we're
going to lose more screen real estate. I don't think I'm in favor of
that at all.
It's not really such a big problem in these times of wide screens any
more. Usually you have to make the page narrower anyway because text
with long lines is not good for readability. But I agree it can still be
a problem if you go several levels down, and the section titles get
indented and longer, then either you need a really wide sidebar or the
entries will we wrapped to several lines. Plus, it creates more noise on
the screen. More whitespace makes makes it more pleasing to read.
So maybe we should completely dismiss the sidebar, and use clean, small
tocs at the top, and properly working breadcrumbs instead. The
SQLAlchemy docs are a good example: http://www.sqlalchemy.org/docs/
-- Christoph
--
You received this message because you are subscribed to the Google Groups
"TurboGears Trunk" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/turbogears-trunk?hl=en.
