Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.
Sign upadd a colophon #62
Comments
bterlson
added
the
editorial change
label
Sep 24, 2015
This comment has been minimized.
Show comment
Hide comment
This comment has been minimized.
bterlson
Nov 13, 2015
Member
2 months later, I have proposed copy for a sub-intro clause:
About This Edition
This edition is authored on GitHub with the help of many members of the ECMAScript community. The source format is an HTML dialect called Ecmarkup. Ecmarkup provides a framework and toolset for authoring ECMAScript specifications that follow the established notational conventions for this document. Ecmarkup builds on and integrates a number of other formats and technologies including Grammarkdown for defining syntax and Ecmarkdown for authoring algorithm steps. Prior editions of this specification were authored using Word&emdash;the Ecmarkup source text that formed the basis of this edition was produced by converting the ECMAScript 2015 Word document to Ecmarkup using an automated conversion tool.
This rendering is produced by using the Ecmarkup toolchain to build the source Ecmarkup format into standard HTML, CSS, and ECMAScript for display in web browsers and printing to PDF or other mediums.
|
2 months later, I have proposed copy for a sub-intro clause: About This EditionThis edition is authored on GitHub with the help of many members of the ECMAScript community. The source format is an HTML dialect called Ecmarkup. Ecmarkup provides a framework and toolset for authoring ECMAScript specifications that follow the established notational conventions for this document. Ecmarkup builds on and integrates a number of other formats and technologies including Grammarkdown for defining syntax and Ecmarkdown for authoring algorithm steps. Prior editions of this specification were authored using Word&emdash;the Ecmarkup source text that formed the basis of this edition was produced by converting the ECMAScript 2015 Word document to Ecmarkup using an automated conversion tool. This rendering is produced by using the Ecmarkup toolchain to build the source Ecmarkup format into standard HTML, CSS, and ECMAScript for display in web browsers and printing to PDF or other mediums. |
This comment has been minimized.
Show comment
Hide comment
This comment has been minimized.
michaelficarra
Nov 16, 2015
Member
Prior editions of this specification [...] an automated conversion tool.
The colophon should be about this particular instance of the work, not a history lesson.
The colophon should be about this particular instance of the work, not a history lesson. |
This comment has been minimized.
Show comment
Hide comment
This comment has been minimized.
domenic
Nov 21, 2015
Member
In that case I think whatever you want to call what was added is strictly more interesting and useful than a colophon, so I would not change anything.
|
In that case I think whatever you want to call what was added is strictly more interesting and useful than a colophon, so I would not change anything. |
michaelficarra commentedSep 22, 2015
A colophon describes the tools and resources used in the creation of a published work. Additionally, it may contain the authorship information such as who created the work, and when and where the work was created.
As an example, see the colophon from Stephen Wolfram's A New Kind of Science.