Permalink
Browse files

Adding PDF documentation.

  • Loading branch information...
1 parent 1a4a46b commit 39039ccc7e924f6a0f818e777477dd8767d75597 @willhardy committed Jul 3, 2011
Showing with 32 additions and 5 deletions.
  1. +2 −2 doc/conf.py
  2. +4 −3 doc/index.rst
  3. +26 −0 doc/pdfindex.rst
View
@@ -178,8 +178,8 @@
# Grouping the document tree into LaTeX files. List of tuples
# (source start file, target name, title, author, documentclass [howto/manual]).
latex_documents = [
- ('index', 'RuntimeDynamicModels.tex', u'Runtime Dynamic Models Documentation',
- u'Will Hardy', 'manual'),
+ ('pdfindex', 'RuntimeDynamicModels.tex', u'Runtime Dynamic Models Documentation',
+ u'Will Hardy', 'howto'),
]
# The name of an image file (relative to this directory) to place at the top of
View
@@ -1,8 +1,9 @@
.. Main landing page for dynamic models documentation.
TODO:
- Add an overview, with practical examples
- Discuss reasons to use / not to use this technique
- Add small section on database errors to db migration page.
+ - Add an overview, with practical examples
+ - Discuss reasons to use / not to use this technique
+ - Add small section on database errors to db migration page.
+ - walkthrough the example implementation
==================================
Runtime Dynamic Models with Django
View
@@ -0,0 +1,26 @@
+.. PDF documentation
+
+==================================
+Runtime Dynamic Models with Django
+==================================
+
+The flexibility of Python and Django allow developers to dynamically create
+models to store and access data using Django's ORM.
+But you need to be careful if you go down this road, especially if your models
+are set to change at runtime.
+This documentation will cover a number of things to consider when making use
+of runtime dynamic models.
+
+An example implementation of dynamic models is also provided for reference.
+It is hosted here on GitHub:
+`willhardy/dynamic-models <https://github.com/willhardy/dynamic-models>`_.
+
+This topic was presented at DjangoCon and these notes have been written
+as supplementary documentation for that talk.
+The talk can be `viewed online here <http://2011.djangocon.eu/talks/22/>`_.
+
+
+.. include:: /topics/model.rst
+.. include:: /topics/model-migration.rst
+.. include:: /topics/database-migration.rst
+.. include:: /topics/admin-migration.rst

0 comments on commit 39039cc

Please sign in to comment.