summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJason Gerard DeRose <jderose@redhat.com>2008-08-14 19:36:54 +0000
committerJason Gerard DeRose <jderose@redhat.com>2008-08-14 19:36:54 +0000
commit43c04f1cd356a46aab6720c64e8d15900b46bfdf (patch)
treec9dff80d191a0f528963fb1228f0e33bf421b38a
parentf423f2c9f0634d3b123eaaae8b13afd83cc0cf94 (diff)
downloadfreeipa.git-43c04f1cd356a46aab6720c64e8d15900b46bfdf.tar.gz
freeipa.git-43c04f1cd356a46aab6720c64e8d15900b46bfdf.tar.xz
freeipa.git-43c04f1cd356a46aab6720c64e8d15900b46bfdf.zip
163: Docstring improvement for ipalib/__init__.py and plugable.py
-rw-r--r--ipalib/__init__.py8
-rw-r--r--ipalib/plugable.py2
2 files changed, 6 insertions, 4 deletions
diff --git a/ipalib/__init__.py b/ipalib/__init__.py
index 309bd2e2..84b529e1 100644
--- a/ipalib/__init__.py
+++ b/ipalib/__init__.py
@@ -20,11 +20,13 @@
"""
The IPA Library.
-To learn about the library, you should probably read the code in this order:
+To learn about the ``ipalib`` library, you should read the code in this order:
- 1. Start with the `ipalib.plugable` module
+ 1. Learn about the plugin framework in `ipalib.plugable`
- 2. Then read the `ipalib.public` module
+ 2. Learn about the public api in `ipalib.public`
+
+ 3. Look at some example plugins in `ipalib.plugins.example`
Some of the plugin architecture was inspired by ``bzr``, so you might also
read http://bazaar-vcs.org/WritingPlugins
diff --git a/ipalib/plugable.py b/ipalib/plugable.py
index 30a4a5f0..60a8c548 100644
--- a/ipalib/plugable.py
+++ b/ipalib/plugable.py
@@ -18,7 +18,7 @@
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
"""
-Generic plugin framework.
+Implementation of the plugin framework.
The classes in this module make heavy use of Python container emulation. If
you are unfamiliar with this Python feature, see