19816 2012-11-01 14:33:31 +0000 Rename Preface to Introduction 2014-03-28 15:56:04 +0000 1 1 1 Unclassified WHATWG Encoding unspecified PC Windows 3.1 RESOLVED FIXED P2 normal Unsorted 1 annevk annevk mike sideshowbarker+encodingspec oldest_to_newest 77662 0 annevk 2012-11-01 14:33:31 +0000 In the introduction add a couple of paragraphs explaining the various sections. 77670 1 annevk 2012-11-01 15:22:14 +0000 Richard Ishida suggested that. 92944 2 annevk 2013-09-04 09:16:48 +0000 Should maybe also explain the history a little bit with (non-normative, doh) pointers to IANA charset, old RFCs, old unicode.org stuff. 97463 3 annevk 2013-12-11 17:32:14 +0000 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. === 103102 4 annevk 2014-03-28 15:56:04 +0000 https://github.com/whatwg/encoding/commit/912006d67c2de734d6e7fa33b7b39be95c1af874