summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/README.md b/README.md
index ba467a6..53d4061 100644
--- a/README.md
+++ b/README.md
@@ -142,6 +142,13 @@ speculatively ("This seems like a good idea").
To write a plugin, see the existing ones for examples, and put it in
`vmdb/plugins/foo_plugin.py` for some value of `foo`.
+You should document the plugin in a Markdown file next to it:
+`vmdb/plugins/foo.mdwn` for plugin mentioned above. See existing
+documentation files for a model. You should mention all keys each step
+can use, and give an example. It would be great to explain when the
+plugin would be useful. Try to keep source lines to less than 80
+characters.
+
Plugins are meant to be very easy to write. If not, there's probably
something wrong with `vmdb2`. Please raise the issue.
@@ -166,6 +173,12 @@ also [CoverageTestRunner][] for running the unit tests.
[cmdtest]: http://liw.fi/cmdtest/
[CoverageTestRunner]: http://liw.fi/coverage-test-runner/
+Try to follow PEP8 for code formatting, and try to keep lines shorter
+than 80 characters.
+
+Make sure ./check and check-all scripts pass both before and after
+your modifications.
+
Contact
-----------------------------------------------------------------------------