diff --git a/doc/examples/idp.rst b/doc/examples/idp.rst
index 849045c..fcb636a 100644
--- a/doc/examples/idp.rst
+++ b/doc/examples/idp.rst
@@ -3,6 +3,18 @@
 An extremly simple example of a SAML2 identity provider.
 ========================================================
 
+There are 2 example IDPs in the project's example directory:
+* idp2 has a static definition of users:
+ * user attributes are defined in idp_user.py
+ * the password is defined in the PASSWD dict in idp.py
+* idp2_repoze is using repoze.who middleware to perform authentication and attribute retrieval
+
+Configuration
+-------------
+Entity configuration is described in "Configuration of pysaml2 entities"
+Server parameters like host and port and various command line parameters are
+defined in the main part of idp.py
+
 Setup:
 ******