start some docs

python/doc/examples.rst

@@ -14,10 +14,11 @@ For example you can type ``python`` and then::
     # instantiate and configure deltachat account
     import deltachat
     ac = deltachat.Account("/tmp/db")
+    ac.set_config("addr", "test2@hq5.merlinux.eu")
+    ac.set_config("mail_pwd", "some password")
 
-    # start configuration activity and smtp/imap threads
-    ac.start_threads()
-    ac.configure(addr="test2@hq5.merlinux.eu", mail_pw="********")
+    # start the IO threads and perform configuration
+    ac.start()
 
     # create a contact and send a message
     contact = ac.create_contact("someother@email.address")

python/doc/index.rst

@@ -4,8 +4,9 @@ deltachat python bindings
 The ``deltachat`` Python package provides two layers of bindings for the
 core Rust-library of the https://delta.chat messaging ecosystem:
 
-- :doc:`api` is a high level interface to deltachat-core which aims
-  to be memory safe and thoroughly tested through continous tox/pytest runs.
+- :doc:`api` is a high level interface to deltachat-core.
+
+- :doc:`plugins` is a brief introduction into implementing plugin hooks.
 
 - :doc:`lapi` is a lowlevel CFFI-binding to the `Rust Core
   <https://github.com/deltachat/deltachat-core-rust>`_.

python/doc/plugins.rst

@@ -0,0 +1,27 @@
+
+Implementing Plugin Hooks
+==========================
+
+The Delta Chat Python bindings use `pluggy <https://pluggy.readthedocs.io>`_
+for managing global and per-account plugin registration, and performing
+hook calls.
+
+
+.. autoclass:: deltachat.register_global_plugin
+
+.. autoclass:: deltachat.account.Account.add_account_plugin
+
+
+Per-Account Hook specifications
+-------------------------------
+
+.. autoclass:: deltachat.hookspec.PerAccount
+    :members:
+
+
+Global Hook specifications
+--------------------------
+
+.. autoclass:: deltachat.hookspec.Global
+    :members:
+