From 726215140a636f0e5e436cce9966e1f306f82019 Mon Sep 17 00:00:00 2001 From: JimJJewett Date: Thu, 27 Oct 2016 12:26:10 -0400 Subject: [PATCH] README.rst should indicate a preference for .rst (#117) --- README.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/README.rst b/README.rst index 12f00dc4b..8675d20fe 100644 --- a/README.rst +++ b/README.rst @@ -14,12 +14,12 @@ now automatically generated, and not committed to the repo. reStructuredText for PEPs ========================= -Original PEP source may be written using two standard formats, a -mildly idiomatic plaintext format and the reStructuredText format -(also, technically plaintext). These two formats are described in -PEP 9 and PEP 12 respectively. The ``pep2html.py`` processing and -installation script knows how to produce the HTML for either PEP -format. +Original PEP source should be written in reStructuredText format, +which is a constrained version of plaintext, and is described in +PEP 12. Older PEPs were often written in a more mildly restricted +plaintext format, as described in PEP 9. The ``pep2html.py`` +processing and installation script knows how to produce the HTML +for either PEP format. For processing reStructuredText format PEPs, you need the docutils package, which is available from `PyPI `_.