From e59365923b4ba5d4f4a61dc772c648a4fa636138 Mon Sep 17 00:00:00 2001
From: markus-oehme-pg40 <63052527+markus-oehme-pg40@users.noreply.github.com>
Date: Fri, 22 Jan 2021 09:29:19 +0100
Subject: [PATCH] doc: Link to detailed extension documentation

I missed that there are actually two sections explaining extensions in the docs and just saw the examples based one. This lead to me thinking "kind of lousy documentation, but that's probably par for the course". Would there have been a pointer to the detailed extension API description it would have saved me hours of guesswork.
---
 doc/development/index.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/doc/development/index.rst b/doc/development/index.rst
index 04918acd6..b4a7920ba 100644
--- a/doc/development/index.rst
+++ b/doc/development/index.rst
@@ -2,10 +2,12 @@
 Extending Sphinx
 ================
 
-This guide is aimed at those wishing to develop their own extensions for
-Sphinx. Sphinx possesses significant extensibility capabilities including the
-ability to hook into almost every point of the build process.  If you simply
-wish to use Sphinx with existing extensions, refer to :doc:`/usage/index`.
+This guide is aimed at giving a quick introduction for those wishing to 
+develop their own extensions for Sphinx. Sphinx possesses significant 
+extensibility capabilities including the ability to hook into almost every
+point of the build process.  If you simply wish to use Sphinx with existing 
+extensions, refer to :doc:`/usage/index`. For a more detailed discussion of
+the extension interface see :doc:`/extdev/index`.
 
 .. toctree::
    :maxdepth: 2