Table of contents
Le 12 août 2014 à 14:32, Perry Smith <pedzsan at gmail.com> a écrit :
Suppose I want to find "bind" in the spec, I open the spec up and search down looking for "bind" but I don't hit it in the table of contents. If I did, I would stop and then hit the link and it would take me to 19.2.3.2.
The TOC has three levels e.g. it has 19.2.3 but not what is under it and there is no index that I'm aware of. Curiously, there are 8 hits for "bind" in the TOC but not the one that I would guess 99% of the users will be looking for.
Is there another way to find the definition of "bind" in the spec? Yes… if I know where its at, I can find it but that what if I don't?
One way to solve this is to make the TOC contain all of the section numbers and not just those within a limited depth.
Perry
What you need here, is indeed an index rather than a TOC.
Usually, when I am in such a situation you describe, I scan the TOC, in order to find the more plausible section (or sections) where I could find the information I'm searching for. For that purpose, a more detailed TOC is unwanted, because it is already very long as it stands now.
On Tue, Aug 12, 2014 at 7:32 AM, Perry Smith <pedzsan at gmail.com> wrote:
Suppose I want to find "bind" in the spec, I open the spec up and search down looking for "bind" but I don't hit it in the table of contents. [...]
Are you using the PDF version or the HTML version?
If the HTML version, grab the source code from jorendorff/es-spec-html, fix it however you think
best, and send me a pull request.
In this particular case, if you search for ".bind" (with a dot) the first hit is Function.prototype.bind.
On Aug 12, 2014, at 9:31 AM, Jason Orendorff <jason.orendorff at gmail.com> wrote:
On Tue, Aug 12, 2014 at 7:32 AM, Perry Smith <pedzsan at gmail.com> wrote:
Suppose I want to find "bind" in the spec, I open the spec up and search down looking for "bind" but I don't hit it in the table of contents. [...]
Are you using the PDF version or the HTML version?
Both... I'm trying to use the HTML version first since my browser searches faster than my pdf readers.
If the HTML version, grab the source code from jorendorff/es-spec-html, fix it however you think best, and send me a pull request.
Very cool. I'll try and do that. I'll also collaborate with you off-list if I have questions, suggestions, etc.
In this particular case, if you search for ".bind" (with a dot) the first hit is Function.prototype.bind.
good hint...
Perry
Suppose I want to find "bind" in the spec, I open the spec up and search down looking for "bind" but I don't hit it in the table of contents. If I did, I would stop and then hit the link and it would take me to 19.2.3.2.
The TOC has three levels e.g. it has 19.2.3 but not what is under it and there is no index that I'm aware of. Curiously, there are 8 hits for "bind" in the TOC but not the one that I would guess 99% of the users will be looking for.
Is there another way to find the definition of "bind" in the spec? Yes… if I know where its at, I can find it but that what if I don't?
One way to solve this is to make the TOC contain all of the section numbers and not just those within a limited depth.
Perry