Let me just concur with Alex,

As someone who reads documentation like literature when getting up to speed on 
a new project...

I'm not fond of alphabetizing API docs, I'd rather them to be done in related 
chunks, from most commonly used to least commonly used.

I'm actually not sure I understand the value of alphabetizing them, given that 
if you know the name already you can search the page.

-- Rebecca


On June 24, 2014 at 5:50:07 AM, Mark Hahn ([email protected]) wrote:

> similar methods are grouped together

It should be totally alphabetic.  You can take care of related methods by using 
links like "See Unlink".


On Mon, Jun 23, 2014 at 11:25 AM, mscdex <[email protected]> wrote:
On Monday, June 23, 2014 11:30:30 AM UTC-4, Matt Sergeant wrote:

On Sun, Jun 22, 2014 at 2:10 AM, Mark Hahn <[email protected]> wrote:
It has driven me crazy for years the the api docs (methods) are in no 
particular order, at least none that I can discern.  I usually have to scroll 
through most of the list to find anything.  Why not list them alphabetically?

Your comment has been out of date for a while now. Check again.

The module methods and events aren't alphabetical, just the main module index. 
I'm not sure there is any specific order to the module methods/events currently 
except in a few cases where similar methods are grouped together (e.g. ref() 
and unref(), and multiple method signatures for the same method name -- such as 
net.connect()).
--
Job board: http://jobs.nodejs.org/
New group rules: 
https://gist.github.com/othiym23/9886289#file-moderation-policy-md
Old group rules: 
https://github.com/joyent/node/wiki/Mailing-List-Posting-Guidelines
---
You received this message because you are subscribed to a topic in the Google 
Groups "nodejs" group.
To unsubscribe from this topic, visit 
https://groups.google.com/d/topic/nodejs/Wg-W2xxZdEY/unsubscribe.
To unsubscribe from this group and all its topics, send an email to 
[email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/nodejs/ef5ddf92-2ee2-4b27-8b0a-19f193f6e996%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

--
Job board: http://jobs.nodejs.org/
New group rules: 
https://gist.github.com/othiym23/9886289#file-moderation-policy-md
Old group rules: 
https://github.com/joyent/node/wiki/Mailing-List-Posting-Guidelines
---
You received this message because you are subscribed to the Google Groups 
"nodejs" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/nodejs/CACrj35E7wvnd-3wBWF%3D3cZiFToMZaQUw0%2BkW%2B_SK%3Dq%3DyL-hgzA%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.

-- 
Job board: http://jobs.nodejs.org/
New group rules: 
https://gist.github.com/othiym23/9886289#file-moderation-policy-md
Old group rules: 
https://github.com/joyent/node/wiki/Mailing-List-Posting-Guidelines
--- 
You received this message because you are subscribed to the Google Groups 
"nodejs" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/nodejs/etPan.53a98bf9.643c9869.139%40Sierra-2.local.
For more options, visit https://groups.google.com/d/optout.

Reply via email to