Hi,

I'm not sure if this is the right place to post my comments, but I'm
unable to find a more appropriate venue. Feel free to redirect me.

Unlike previous versions, the 2.0 documentation lacks heading links
within the TOC. It used to be that when viewing a particular topic you
could access subtopics easily. For example, the 2.0 page on FormHelper
is extremely long and finding information on, say, structuring a
select options array can be maddening if you don't know where in the
page to look. Once found you can bookmark the paragraph's permalink,
but that's not very useful for quick reference lookups.

Also, the current topic is not highlighted in the TOC navigation. It
would be helpful for the user to know where they are at any given
point. A breadcrumb trail might help here.

Lastly, I'm wondering why user comments aren't allowed. I know that a
lot of comments can make a page unwieldy, but I thought the pre-1.3
doc pages handled it well, with comments for each section available by
click. I often found those comments quite helpful.

I greatly appreciate the amount of information contained in the book
as well as the time and effort it must have taken to put these docs
together, but it seems to me that some attention to some basic
navigation UI would help tremendously.

Many thanks,
-Brian

-- 
Our newest site for the community: CakePHP Video Tutorials 
http://tv.cakephp.org 
Check out the new CakePHP Questions site http://ask.cakephp.org and help others 
with their CakePHP related questions.


To unsubscribe from this group, send email to
cake-php+unsubscr...@googlegroups.com For more options, visit this group at 
http://groups.google.com/group/cake-php

Reply via email to