I've said it before, but it bears repeating: the documentation for web2py 
is fantastic. One thing that might improve the usability of the online 
documentation is to make the table of contents a fixed pane that moves with 
the reader as they scroll. This would save many trips back up to the top of 
the page to navigate the book.

This would be as simple as changing the css to position:fixed (OK, I know, 
there would be more css tweaking involved, but it's pretty simple). The 
nice thing about this approach is that if a browser lacks fixed positioning 
the TOC would just stay where it is -- i.e., easy fallback to the current 
layout.

A slightly more involved improvement would be to make that left-hand TOC 
dynamically expandable. Of course this will involve some js, but it is 
again a pretty basic operation and in combination with the fixed TOC pane 
it would make that documentation infinitely more convenient to use.

I should say, by the way, that I also own a pdf copy of the web2py book. 
But I generally use the web version because it's so much more up-to-date. 
When another pdf version comes out I'll buy it in order to support the 
platform and Massimo. So I hope there's no fear that better online nav will 
cut into pdf sales.

Cheers.

Reply via email to