[Python-checkins] r57119 - sandbox/trunk/pep0/NOTES

[brett.cannon]

Author: brett.cannon
Date: Fri Aug 17 04:59:27 2007
New Revision: 57119

Modified:
   sandbox/trunk/pep0/NOTES
Log:
Update with a list of exactly what is left to do to complete this work.


Modified: sandbox/trunk/pep0/NOTES
==============================================================================
--- sandbox/trunk/pep0/NOTES	(original)
+++ sandbox/trunk/pep0/NOTES	Fri Aug 17 04:59:27 2007
@@ -1,54 +1,20 @@
 TODO
 -----
 
-* Read PEPs as UTF-8.
+* Explicitly read PEPs as UTF-8.
 
-* Author/email list.
-    + Decide on final format of email lists.
-        - Parse new format.
-        - Warn on PEPs using the old format.
-    + Fix loss of a single space when name contains an accented character.
+* Use unicodedata to reformat author names to NFC (or NFKC, not sure which) to
+  make Unicode characters count as one when taking the len of a unicode string.
 
-* Verify PEP is well-formatted.
-    + Formatting correct.
-        - Plaintext.
-        - reST.
+* Backport email addresses from old PEP 0 to PEPs themselves.
 
-
-Inconsistencies/Things To Improve
----------------------------------
-* Within PEPs:
-
-    + Author field
-        - Three different formats for author (two include an email address).
-        - Best to settle on a single format.
-            * Author names separated by commas.
-            * Maintain email addresses only in PEP index so as to always have
-              up-to-date address in a single location.
-
-    + Type field
-        - Meta-PEPs are not delineated as such (e.g., usually specified as
-          Informative).
-
-* In the index:
-
-    * Counting gap in numerical index and a newline.
-        + 42/100, 160/200.
-        + No other spaces in the count are used (e.g., 666/754).
-        + Have no spaces, always have a space?
-        + Should jumps in thousands digit have more than a single newline?
-
-    * Titles that are longer than allowed.
-        + 311, 3001.
-        + Use custom titles to fit.
-        + Possible solutions.
-            - Use ellipsis to shorten name for index?
-            - Just deal with some being longer than expected?
-
-    * Type/Status field.
-        + Active and Draft status is not listed in index.
-            - Conflicts with Accepted and Deferred initials, respectively.
-            - Worth using other letters?
-
-    * Disparity between author name in PEPs and listed in index.
-        + E.g., "Barry A. Warsaw" and "Warsaw, Barry".
+* Add support for author names formatted as "Last, First, Suffix".
+    + Separate by semi-colon or newlines.
+    + Email address in angle brackets.
+        - Optional to have.
+    + Output warnings for PEPs that are using an old format.
+
+* Decide how to deal with authors who have the same last name (e.g., Guido and
+  Just).
+    + First initial?
+    + Nicknames?