Opened 15 years ago

Closed 14 years ago

Last modified 12 years ago

#9170 closed (fixed)

Write real documentation for custom management commands

Reported by: James Bennett Owned by: David Fischer
Component: Documentation Version: dev
Severity: Keywords:
Cc: djfische@… Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

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.

Attachments (2)

9170_manage_command.diff (4.1 KB ) - added by Eric Holscher 14 years ago.
Super basic example and simple reference
management-commands-9170.diff (9.7 KB ) - added by David Fischer 14 years ago.
Added a complete tutorial of adding a management command

Download all attachments as: .zip

Change History (10)

comment:1 by James Bennett, 15 years ago

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

comment:2 by anonymous, 15 years ago

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

comment:3 by Eric Holscher, 15 years ago

Triage Stage: UnreviewedAccepted

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/

by Eric Holscher, 14 years ago

Attachment: 9170_manage_command.diff added

Super basic example and simple reference

comment:4 by Eric Holscher, 14 years ago

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!

by David Fischer, 14 years ago

Added a complete tutorial of adding a management command

comment:5 by David Fischer, 14 years ago

Cc: djfische@… added
Has patch: set
Owner: changed from nobody to David Fischer
Status: newassigned
Version: 1.0SVN

comment:6 by Eric Holscher, 14 years ago

milestone: 1.2

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.

comment:7 by Brian Rosner, 14 years ago

Resolution: fixed
Status: assignedclosed

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

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

comment:8 by Jacob, 12 years ago

milestone: 1.2

Milestone 1.2 deleted

Note: See TracTickets for help on using tickets.
Back to Top