php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Bug #44689 Sort the extension categories alphabetically
Submitted: 2008-04-11 03:51 UTC Modified: 2008-04-11 22:34 UTC
From: routinet at hotmail dot com Assigned: bjori (profile)
Status: Closed Package: Doc Build problem
PHP Version: Irrelevant OS: no matter
Private report: No CVE-ID: None
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: routinet at hotmail dot com
New email:
PHP Version: OS:

 

 [2008-04-11 03:51 UTC] routinet at hotmail dot com
Description:
------------
Please put back the extended table of contents.  I appreciate your efforts to make the docs more aesthetically pleasing, but the detailed version was quite a help.

Reproduce code:
---------------
none

Expected result:
----------------
none

Actual result:
--------------
none

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2008-04-11 04:00 UTC] philip@php.net
Please be more specific with what you mean. Do you mean you miss having every extension listed alphabetically in the left sidebar?
 [2008-04-11 06:44 UTC] routinet at hotmail dot com
Yes, that too.  :)

I have bookmarked http://www.php.net/manual/en/.  Until recently, that page displayed a very detailed table of contents which included the major subsections within each chapter.  For example, under "Language Reference", there was a list of direct links to "Basic Syntax", "Types", "Variables", etc.  (the first-level bullet points found at http://www.php.net/manual/en/langref.php)

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*).  I would like to see the chapter currently being viewed expanded there.  For example, the alphabetical extension listing would only show up if I were looking at the "Function Reference" chapter.  Perhaps create an expandable tree view there, such that the user could drill down into details as they wished?
 [2008-04-11 07:21 UTC] derick@php.net
I agree, the navigation now is much worse than before.
 [2008-04-11 08:16 UTC] 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 08:53 UTC] 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 09:04 UTC] 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 09:20 UTC] 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:32 UTC] bjori@php.net
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.
 [2008-04-11 21:30 UTC] bjori@php.net
The orginal index page has now been "restored" so the only issue is alphabetical sorting of extensions categories, correct?
 [2008-04-11 22:34 UTC] philip@php.net
Everything is alphabetized now in manual.xml.in so this bug is closed. The changes will show up online sometime, likely next week.
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Sun Dec 22 01:01:30 2024 UTC