From 954708878ff4a094946e69f2fd8892f3fda0e863 Mon Sep 17 00:00:00 2001 From: Carol Willing Date: Wed, 16 May 2018 14:08:31 -0400 Subject: [PATCH] PEP 1: Add a teachability section to suggested PEP content (#652) --- pep-0001.txt | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/pep-0001.txt b/pep-0001.txt index 23ca18abb..ab2d2db84 100644 --- a/pep-0001.txt +++ b/pep-0001.txt @@ -345,6 +345,15 @@ Each PEP should have the following parts: appropriate for either the Python language reference or the standard library reference. +9. How to Teach This -- For a PEP that adds new functionality or changes + language behavior, it is helpful to include a section on how to + teach users, new and experienced, how to apply the PEP to their + work. + + This section may include key points and recommended documentation + changes that would help users adopt a new feature or migrate their + code to use a language change. + PEP Formats and Templates =========================