From a7d66f9f055744229715aea0ddb42ac7f342a945 Mon Sep 17 00:00:00 2001
From: Petr Viktorin <pviktori@redhat.com>
Date: Sat, 25 Nov 2017 17:40:20 +0100
Subject: [PATCH] Doc: Include information from python-ldap.org/docs.html

---
 Doc/index.rst     | 12 +++++++++++
 Doc/resources.rst | 55 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 67 insertions(+)
 create mode 100644 Doc/resources.rst

diff --git a/Doc/index.rst b/Doc/index.rst
index 5142baa..43f57c0 100644
--- a/Doc/index.rst
+++ b/Doc/index.rst
@@ -37,6 +37,17 @@ You can `subscribe or unsubscribe`_ to this list or browse the `list archive`_.
 .. _list archive: https://mail.python.org/pipermail/python-ldap/
 
 
+Documentation
+-------------
+
+The documentation for python-ldap 3.x is hosted at `Read the Docs`_.
+
+You can switch between versions of the library, or download PDF or HTML
+versions for offline use, using the right sidebar.
+
+.. _Read the Docs: http://python-ldap.readthedocs.io/en/latest/
+
+
 Contents
 --------
 
@@ -45,6 +56,7 @@ Contents
 
    installing.rst
    reference/index.rst
+   resources.rst
 
 
 Bytes/text management
diff --git a/Doc/resources.rst b/Doc/resources.rst
new file mode 100644
index 0000000..56cb1a1
--- /dev/null
+++ b/Doc/resources.rst
@@ -0,0 +1,55 @@
+Third-party documentation
+=========================
+
+The following documents referenced are not written by python-ldap project
+members. Therefore some information might be outdated or links might be broken.
+
+
+*Python LDAP Applications* articles by Matt Butcher
+---------------------------------------------------
+
+* `Part 1 - Installing and Configuring the Python-LDAP Library and Binding to an LDAP Directory <https://www.packtpub.com/article/installing-and-configuring-the-python-ldap-library-and-binding-to-an-ldap-directory>`_
+
+    This also covers SASL.
+
+* `Part 2 - LDAP Operations <https://www.packtpub.com/article/python-ldap-applications-ldap-opearations>`_
+* `Part 3 - More LDAP Operations and the LDAP URL Library <https://www.packtpub.com/article/python-ldap-applications-more-ldap-operations-and-the-ldap-url-library>`_
+* `Part 4 - LDAP Schema <https://www.packtpub.com/article/python-ldap-applications-ldap-schema>`_
+
+    Gee, someone waded through the badly documented mysteries of module
+    :mod:`ldap.schema`.
+
+
+`LDAP Programming in Python <https://www.linuxjournal.com/article/6988>`_
+-------------------------------------------------------------------------
+
+Another article for getting started with python-ldap.
+
+
+
+`RFC 1823 <https://tools.ietf.org/html/rfc1823>`_
+-------------------------------------------------
+
+The LDAP Application Program Interface, mainly for LDAPv2.
+
+
+
+`LDAPEXT draft <https://tools.ietf.org/html/draft-ietf-ldapext-ldap-c-api>`_
+----------------------------------------------------------------------------
+
+The Internet draft of the discontinued IETF working group LDAPEXT is of
+interest here since the OpenLDAP 2 libs implement this (expired) draft.
+
+
+`OpenLDAP <https://www.openldap.org/>`_
+---------------------------------------
+
+It's worth to have a look at the
+`manual pages <https://www.openldap.org/software/man.cgi?query=ldap>`_ and the
+`Developer's FAQ <https://www.openldap.org/faq/data/cache/4.html>`_.
+
+
+`VSLDAP <https://www.opengroup.org/openbrand/testing/checklist/guide/config_base.html>`_
+----------------------------------------------------------------------------------------
+
+VSLDAP Interoperability Test Suite.