Bug 19816 - Rename Preface to Introduction
Summary: Rename Preface to Introduction
Status: RESOLVED FIXED
Alias: None
Product: WHATWG
Classification: Unclassified
Component: Encoding (show other bugs)
Version: unspecified
Hardware: PC Windows 3.1
: P2 normal
Target Milestone: Unsorted
Assignee: Anne
QA Contact: sideshowbarker+encodingspec
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-11-01 14:33 UTC by Anne
Modified: 2014-03-28 15:56 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Anne 2012-11-01 14:33:31 UTC
In the introduction add a couple of paragraphs explaining the various sections.
Comment 1 Anne 2012-11-01 15:22:14 UTC
Richard Ishida suggested that.
Comment 2 Anne 2013-09-04 09:16:48 UTC
Should maybe also explain the history a little bit with (non-normative, doh) pointers to IANA charset, old RFCs, old unicode.org stuff.
Comment 3 Anne 2013-12-11 17:32:14 UTC
Here is a sketch for what this could be. I don't really like it.

===
The section "Encodings" defines the general structure of an encoding, including its decoder and encoder functionality. As well as defining the full list of labels, the encodings they map to, and an algorithm for obtaining an encoding from a presumed label.

The section "Indexes" defines the general structure of an index, used by an encoding's decoder and encoder, and lists the indexes used by encodings that use more than one byte to encode certain code points.

The section "Decode and encode" defines entry points for use by other standards.

The section "API" defines a JavaScript API to make encodings accessible to script.

The remaining sections define the decoder and encoder algorithms of the encodings.
===