From 8b3b90eb96d6b0cbec63fe6ffa19b4cf025a605e Mon Sep 17 00:00:00 2001
From: Stephane Wirtel <stephane@wirtel.be>
Date: Tue, 25 Jul 2017 19:12:30 +0200
Subject: [PATCH 1/2] Add a section 'Extensions'

---
 extensions.rst | 13 +++++++++++++
 index.rst      |  3 ++-
 2 files changed, 15 insertions(+), 1 deletion(-)
 create mode 100644 extensions.rst

diff --git a/extensions.rst b/extensions.rst
new file mode 100644
index 0000000000..afe2e9480c
--- /dev/null
+++ b/extensions.rst
@@ -0,0 +1,13 @@
+.. _extensions:
+
+Write a CPython extension
+=========================
+
+In this section, we could explain how to write a CPython extension with the C language, but the topic can take a complete book.
+
+For this reason, we prefer to give you some links where you can read a very good documentation.
+
+Read the following references:
+
+* https://docs.python.org/3.7/extending/
+* https://pythonextensionpatterns.readthedocs.io/en/latest/
diff --git a/index.rst b/index.rst
index 269f0bd0a8..89e2dff20b 100644
--- a/index.rst
+++ b/index.rst
@@ -12,7 +12,7 @@ Quick Reference
 ---------------
 
 Here are the basic steps needed to get :ref:`set up <setup>` and contribute a
-patch. This is meant as a checklist, once you know the basics. For complete 
+patch. This is meant as a checklist, once you know the basics. For complete
 instructions please see the :ref:`setup guide <setup>`.
 
 1. Install and set up :ref:`Git <vcsetup>` and other dependencies
@@ -322,6 +322,7 @@ Full Table of Contents
    exploring
    grammar
    compiler
+   extensions
    coverity
    clang
    buildslave

From dc74c908586725776665c427be97989e4260abb6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Wirtel?= <stephane@wirtel.be>
Date: Tue, 31 Jul 2018 16:52:42 +0200
Subject: [PATCH 2/2] Update with the recommendations of Nick Coghlan

---
 extensions.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/extensions.rst b/extensions.rst
index afe2e9480c..896d2f9a7d 100644
--- a/extensions.rst
+++ b/extensions.rst
@@ -1,7 +1,7 @@
 .. _extensions:
 
-Write a CPython extension
-=========================
+Updating standard library extension modules
+===========================================
 
 In this section, we could explain how to write a CPython extension with the C language, but the topic can take a complete book.
 
@@ -9,5 +9,7 @@ For this reason, we prefer to give you some links where you can read a very good
 
 Read the following references:
 
-* https://docs.python.org/3.7/extending/
+* https://docs.python.org/dev/c-api/
+* https://docs.python.org/dev/extending/
+* https://www.python.org/dev/peps/pep-0399/
 * https://pythonextensionpatterns.readthedocs.io/en/latest/