Write real documentation for custom management commands

[James Bennett]

​The current documentation doesn't really provide any useful information.

A good starting point would be to give docstrings to the classes and functions in django/core/management/base.py.

[James Bennett]

(In [9082]) Add some docstrings to the base classes for management commands. Refs #9170.

[anonymous]

Might do a screencast on this as well. But real documentation is your friend as well.

[Eric Holscher]

This is true. Two devs have blog posts on the topic, perhaps we should Sphinxify them and add them to the docs?

​http://oebfare.com/blog/2008/nov/03/writing-custom-management-command/
​http://www.b-list.org/weblog/2008/nov/14/management-commands/

[Eric Holscher]

Super basic example and simple reference

[Eric Holscher]

Uploaded some basic docs that have a simple example and mention the different kinds of management commands. Not a lot, but this really needs some better docs!

[David Fischer]

Added a complete tutorial of adding a management command

[Eric Holscher]

Applied this to trunk and it looks and works well. There is a mixing of reference material here with a turorial, so we might want to split that out into a seperate page, but it seems small enough that keeping it together also makes sense.

I think this should go into 1.2 though, because this has been an oddly undocumented part of Django for a while.

[Brian Rosner]

(In [13138]) Fixed #9170 -- added improved custom management command documentation.

Thanks to David Fischer and Eric Holscher for their work on initial patches.

[Jacob]

Milestone 1.2 deleted