Updated readme a bit.

jschrewe · jschrewe · commit aa38c4e34413 · 2011-09-18T18:50:02.000+02:00
diff --git a/readme.md b/readme.md
@@ -4,17 +4,39 @@ This is an implementation of django's model forms for mongoengine documents.
 
 ## Requirements
 
- * mongoengine
+ * [mongoengine](http://mongoengine.org/)
 
 ## Usage
 
+mongodbforms supports forms for normal documents and embedded documents. 
 
+### Normal documents
 
-## What works and doesn't work
+To use mongodbforms with normal documents replace djangos forms with mongodbform forms.
 
-django-mongodbforms currently only supports the most basic things and even they are not really tested.
+    from mongodbforms import DocumentForm
+
+    class BlogForm(DocumentForm)
+        ...
+
+### Embedded documents
+
+For embedded documents use `EmbeddedDocumentForm`. The Meta-object of the form has to be provided with an embedded field name. The embedded object is appended to this. The form constructor takes an additional argument: The document the embedded document gets added to.
 
-Changelists only support basic listings you probably won't be able to use fieldlists and every other feature that django supports for changelists (search, etc.).
+    # forms.py
+    from mongodbforms import EmbeddedDocumentForm
+    
+    class MessageForm(EmbeddedDocumentForm):
+        class Meta:
+		    document = Message
+		    embedded_field_name = 'messages'
+    
+		    fields = ['subject', 'sender', 'message',]
 
-Inline admin objects are created automatically for embedded objects, but can't be defined manually for referenced objects. Although I haven't tested it, field widget can't be overwritten.
+    # views.py
+    form = MessageForm(parent_document=some_document, ...)
+
+## What works and doesn't work
+
+django-mongodbforms currently only supports the most basic things and even they are not really tested.
 
