#44689 [Asn]: old table of contents in documentation

ID: 44689 Updated by: bjori@php.net Reported By: routinet at hotmail dot com Status: Assigned Bug Type: Doc Build problem Operating System: no matter PHP Version: Irrelevant Assigned To: bjori New Comment: Interesting and a good point. I don't remember why the categories aren't alphabetical, but there was a reason for it.. I'll see if I can find it, or fix it. Previous Comments: ------------------------------------------------------------------------ [2008-04-11 09:20:56] routinet at hotmail dot com I understand and agree about the left TOC in regard to extensions. It is quite a big list. The alternative list feels like home. I'll keep it handy. > Alphabetical listing from the left-and TOC will however not get > back in, it was completely uncontrollable. The left hand TOC only > lists "related" (same category) extensions. I meant to sort the categories as they are now, like: * Affecting PHP's Behaviour * Audio Formats Manipulation * Authentication Services ------------------------------------------------------------------------ [2008-04-11 09:04:24] bjori@php.net > Still, the original index.php was quick. One click vs. > two clicks, I suppose. Why not use both? I don't think we can, for technical reasons. I'll look into it though. > I certainly agree. It offers an excellent level of detail. > I find the alphabetical list of extensions easier to use than the > categorized version, however, and the latter could benefit > from some sorting as well. Same idea: why not both? Alternative extension categorization is available from http://php.net/extensions, I suppose we can add alphabetical categorization there. Alphabetical listing from the left-and TOC will however not get back in, it was completely uncontrollable. The left hand TOC only lists "related" (same category) extensions. -Hannes ------------------------------------------------------------------------ [2008-04-11 08:53:07] routinet at hotmail dot com Maybe I'm just resistant to change. > These are still there, and even more detailed listing and > description for each chapter and subsection, from the TOC > on the left. I compared to Aug2007 from archive.org, and I have to say it is a great improvement. Still, the original index.php was quick. One click vs. two clicks, I suppose. Why not use both? > The left hand navigation is much more detailed now and contains > all its parent chapter and a detailed subsection listing with > (hopefully) better description for each subchapter I certainly agree. It offers an excellent level of detail. I find the alphabetical list of extensions easier to use than the categorized version, however, and the latter could benefit from some sorting as well. Same idea: why not both? ------------------------------------------------------------------------ [2008-04-11 08:16:41] bjori@php.net > For example, under "Language Reference", > there was a list of direct links to "Basic Syntax", "Types", These are still there, and even more detailed listing and description for each chapter and subsection, from the TOC on the left. > I very much miss the left nav as well. The chapter-level TOC > is fine for the most part (providing the detailed TOC is still > available *somewhere*). The left hand navigation is much more detailed now and contains all its parent chapter and a detailed subsection listing with (hopefully) better description for each subchapter ------------------------------------------------------------------------ [2008-04-11 07:21:00] derick@php.net I agree, the navigation now is much worse than before. ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/44689 -- Edit this bug report at http://bugs.php.net/?id=44689&edit=1