From: Colin Powell <colin@onecardinal.com>
Date: Fri, 1 Apr 2011 21:59:27 +0000 (-0400)
Subject: Initial commit.
X-Git-Url: https://git.parisson.com/?a=commitdiff_plain;h=bd2a58e9b1db6a23e1fbd549fc6bf243935b097c;p=django-notes.git

Initial commit.
---

bd2a58e9b1db6a23e1fbd549fc6bf243935b097c
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6ba7bf2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+django-notes
+=============
+
+A simple application to allow you to attach notes to models.
+
+Installation
+-------------
+
+Notes uses generic relations to handle attaching themselves to models. So installation is basically just like adding a generic relation item to your model.
+
+1. Add 'notes' to your INSTALLED_APPS variable
+2. Import the Note model:
+
+        from notes.models import Note
+
+3. Add the note inline to your model's admin def in your admin.py file:
+
+        from notes.admin import NoteInline
+
+        class YourModelAdmin(admin.ModelAdmin):
+            inlines = [ NoteInline, ]
+        
+4. To enable easy management you can add a hook to your model:
+
+        notes=generic.GenericRelation(Note)
+
+Usage
+------
+Follow the steps above (including 4) and you should have access to all the notes at instance_of_yourmodel.notes_set.all():
+
+    >>> object = YourModel.objects.get(pk=1)
+    >>> notes_for_object = object.notes_set.all()
+
+Simple.
\ No newline at end of file