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

That is what tutorials are for and there are a zillion on the web.  Why are
almost all others in alphabetic order?  I assume to look something up
quickly without the hassle of ctrl-F.


On Tue, Jun 24, 2014 at 7:32 AM, Rebecca Turner <[email protected]> wrote:

> 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
>> <https://groups.google.com/d/msgid/nodejs/ef5ddf92-2ee2-4b27-8b0a-19f193f6e996%40googlegroups.com?utm_medium=email&utm_source=footer>
>> .
>> 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
> <https://groups.google.com/d/msgid/nodejs/CACrj35E7wvnd-3wBWF%3D3cZiFToMZaQUw0%2BkW%2B_SK%3Dq%3DyL-hgzA%40mail.gmail.com?utm_medium=email&utm_source=footer>
> .
> 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 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/etPan.53a98bf9.643c9869.139%40Sierra-2.local
> <https://groups.google.com/d/msgid/nodejs/etPan.53a98bf9.643c9869.139%40Sierra-2.local?utm_medium=email&utm_source=footer>
> .
> 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/CACrj35FkB8-boh7eWieHQo_iLRnos_%3D8RDSFcX5ceAv%2BshDAmA%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to