On Fri, Jan 4, 2013 at 11:21 AM, Gael Guennebaud
<gael.guennebaud@xxxxxxxxx> wrote:
Thanks for taking the time to look at the proposals. It seems the opinions are converging. Good!
Nevertheless, I made a last attempt that is in-between 3 and 4: it use the grouping mechanism of 3, but a structure more like 4 where the "-> Reference" link has been replaced by the true reference block with Modules and Classes:
I also tweaked the _javascript_ to enforce the "Chapters" section to be expanded whatsoever. This is probably the most interesting thing about this variant, and the same trick can be applied the #4 one to keep the first level of the User Manual always visible.
If you are only interested by the reference pages, then 4 remains better.
+1 for having the first level under Chapters expanded by default. I don't have a strong opinion on this proposal (let's call it 5) vs. 4, but given to choose, I'd go for 5. If we expand by default the first level inside Chapters (or reference and manuals in 4), then 5 looks cleaner.
Also, how about reordering the tree as:
(Remove top-level Eigen)
- Getting started
- Chapters
- General topics (rename?)
- Porting from Eigen2 to Eigen3 (nest inside general topics?)
- Class list
Cheers,
Adolfo.