This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

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

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.
===