From 3bcdbba10055ba0d0bd3ce52d6332ab0f0a41104 Mon Sep 17 00:00:00 2001
From: Carol Willing <carolcode@willingconsulting.com>
Date: Mon, 26 Mar 2018 07:42:50 -0700
Subject: [PATCH 1/2] add appendix with topic pathways

---
 appendix.rst | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 index.rst    |  2 +-
 2 files changed, 59 insertions(+), 1 deletion(-)
 create mode 100644 appendix.rst

diff --git a/appendix.rst b/appendix.rst
new file mode 100644
index 000000000..a98644f18
--- /dev/null
+++ b/appendix.rst
@@ -0,0 +1,58 @@
+Appendix: Topics 
+================
+
+Basics
+------
+
+* :doc:`setup`
+* :doc:`help`
+* :doc:`communication`
+
+Core developers
+---------------
+
+* :doc:`coredev`
+* :doc:`committing`
+* :doc:`developers`
+* :doc:`motivations`
+* :doc:`experts`
+
+Development workflow for contributors
+-------------------------------------
+
+* :doc:`devcycle`
+* :doc:`pullrequest`
+* :doc:`fixingissues`
+
+Documenting Python and style guide
+----------------------------------
+
+* :doc:`docquality`
+* :doc:`documenting`
+
+Issue tracking and triaging
+---------------------------
+
+* :doc:`tracker`
+* :doc:`triaging`
+
+Language development in depth
+-----------------------------
+
+* :doc:`exploring`
+* :doc:`grammar`
+* :doc:`compiler`
+* :doc:`stdlibchanges`
+* :doc:`langchanges`
+* :doc:`porting`
+
+Testing and continuous integration
+----------------------------------
+
+* :doc:`runtests`
+* :doc:`coverage`
+* :doc:`silencewarnings`
+* :doc:`buildbots`
+* :doc:`buildworker`
+* :doc:`coverity`
+  
\ No newline at end of file
diff --git a/index.rst b/index.rst
index 8cb9c1273..f759b665d 100644
--- a/index.rst
+++ b/index.rst
@@ -345,7 +345,7 @@ Full Table of Contents
    buildworker
    motivations
    gitbootcamp
-
+   appendix
 
 .. _Buildbot status: https://www.python.org/dev/buildbot/
 .. _Misc directory: https://github.com/python/cpython/tree/master/Misc

From d770a3ec0742a67172a27a74a5f507f780a65dff Mon Sep 17 00:00:00 2001
From: Carol Willing <carolcode@willingconsulting.com>
Date: Mon, 26 Mar 2018 21:07:24 -0700
Subject: [PATCH 2/2] add @eziomelotti review feedback

---
 appendix.rst | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/appendix.rst b/appendix.rst
index a98644f18..f2db2ac2e 100644
--- a/appendix.rst
+++ b/appendix.rst
@@ -1,18 +1,27 @@
 Appendix: Topics 
 ================
 
-Basics
-------
+Basics for contributors
+-----------------------
+
+.. note:: **Recommended reading**
+
+   - :doc:`setup`
+   - :doc:`pullrequest`
 
-* :doc:`setup`
 * :doc:`help`
 * :doc:`communication`
 
 Core developers
 ---------------
 
+.. note:: **Recommended reading**
+
+   * :doc:`setup`
+   * :doc:`pullrequest`
+   * :doc:`committing`
+
 * :doc:`coredev`
-* :doc:`committing`
 * :doc:`developers`
 * :doc:`motivations`
 * :doc:`experts`