New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add a colophon #62

Closed
michaelficarra opened this Issue Sep 22, 2015 · 3 comments

Comments

Projects
None yet
3 participants
@michaelficarra
Member

michaelficarra commented Sep 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.

@bterlson

This comment has been minimized.

Show comment
Hide comment
@bterlson

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.

Member

bterlson commented Nov 13, 2015

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.

@michaelficarra

This comment has been minimized.

Show comment
Hide comment
@michaelficarra

michaelficarra Nov 16, 2015

Member

👍 I like it, other than the sentence

Prior editions of this specification [...] an automated conversion tool.

The colophon should be about this particular instance of the work, not a history lesson.

Member

michaelficarra commented Nov 16, 2015

👍 I like it, other than the sentence

Prior editions of this specification [...] an automated conversion tool.

The colophon should be about this particular instance of the work, not a history lesson.

@domenic

This comment has been minimized.

Show comment
Hide comment
@domenic

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.

Member

domenic commented Nov 21, 2015

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment