1 files changed, 81 insertions, 0 deletions
diff --git a/docs/source/examples/v3arch/asyncore/contents.rst b/docs/source/examples/v3arch/asyncore/contents.rst
new file mode 100644
index 0000000..54db9fc
--- /dev/null
+++ b/docs/source/examples/v3arch/asyncore/contents.rst
@@ -0,0 +1,81 @@
+
+SNMP with Asyncore
+==================
+
+If you find yourself unable to use particular SNMP feature with the 
+high-level, "oneliner" API, your next step would be to use SNMPv3 
+engine services through one of the Standard SNMP Applications 
+(`RFC3413 <https://tools.ietf.org/html/rfc3413>`_).
+
+There're a large number of SNMPv3 Native API example scripts on this 
+website. Most of them serve a very specific purpose like talking arbitrary 
+SNMP version or handling particular PDU type. That dedication of 
+features serve the purpose of simplifying example code and easing 
+your studies.
+
+Since all these examples are built on top of common PySNMP components 
+like SNMP engine, asyncore-based I/O dispatcher, configuration datastore,
+you could always combine parts of the examples for getting a new breed 
+of SNMP application best matching your needs.
+
+Command Generator Applications
+------------------------------
+
+.. toctree::
+
+   /examples/v3arch/asyncore/manager/cmdgen/snmp-versions
+   /examples/v3arch/asyncore/manager/cmdgen/modifying-variables
+   /examples/v3arch/asyncore/manager/cmdgen/walking-operations
+   /examples/v3arch/asyncore/manager/cmdgen/table-operations
+   /examples/v3arch/asyncore/manager/cmdgen/mib-tweaks
+   /examples/v3arch/asyncore/manager/cmdgen/transport-tweaks
+   /examples/v3arch/asyncore/manager/cmdgen/advanced-topics
+.. XXX /examples/v3arch/asyncore/manager/cmdgen/asynchronous-operations
+
+
+Command Responder Applications
+------------------------------
+
+.. toctree::
+
+   /examples/v3arch/asyncore/agent/cmdrsp/snmp-versions
+   /examples/v3arch/asyncore/agent/cmdrsp/agent-side-mib-implementations
+   /examples/v3arch/asyncore/agent/cmdrsp/transport-tweaks
+   /examples/v3arch/asyncore/agent/cmdrsp/advanced-topics
+
+Notification Originator Applications
+------------------------------------
+
+.. toctree::
+
+   /examples/v3arch/asyncore/agent/ntforg/snmp-versions
+   /examples/v3arch/asyncore/agent/ntforg/common-notifications
+   /examples/v3arch/asyncore/agent/ntforg/evaluating-notification-type
+   /examples/v3arch/asyncore/agent/ntforg/multiple-managers-operations
+   /examples/v3arch/asyncore/agent/ntforg/transport-tweaks
+   /examples/v3arch/asyncore/agent/ntforg/advanced-topics
+.. XXX /examples/v3arch/asyncore/agent/ntforg/snmp-v1-trap-variants
+
+
+Notification Receiver Applications
+----------------------------------
+
+.. toctree::
+
+   /examples/v3arch/asyncore/manager/ntfrcv/snmp-versions
+   /examples/v3arch/asyncore/manager/ntfrcv/transport-tweaks
+   /examples/v3arch/asyncore/manager/ntfrcv/advanced-topics
+
+Proxy Forwarder Applications
+----------------------------
+
+.. toctree::
+
+   /examples/v3arch/asyncore/proxy/command/transport-conversion
+   /examples/v3arch/asyncore/proxy/command/protocol-conversion
+
+
+For more details on PySNMP programming model and interfaces, please 
+refer to the documentation
+
+