Re: announcing normative ECMAScript specification in HTML

On 5/24/12, Allen Wirfs-Brock <allen@wirfs-brock.com> wrote:
> Ecma International now hosts a normative HTML copy of Ecma-262, Edition 5.1
> The ECMAScript Language Specification.  The document includes a hyperlinked
> table of contents and supports external linking to  sections listed in the
> table of contents.
>
> The document may be accessed at http://ecma-international.org/ecma-262/5.1
>
This is good news.

Minor but I'll say it anyway: Don't instruct users on where to click.
What you have now:

"This ECMAScript Language Specification is also available in HTML file
format _here_."

Instead link the html version in the table:
"The following file can be freely downloaded:"

(Change to use plural "files")

"The following files can be freely downloaded:"
ECMA-262.pdf    3 067 290     Acrobat (r) PDF file
ECMA-262.html    3 067 290     text/html

With a big bold orange link for the html version.
-- 
Garrett
Twitter: @xkit
personx.tumblr.com