#8496: django.contrib.admindoc no refernce in documentation
------------------------------------+---------------------------------------
Reporter: ericvw | Owner: nobody
Status: new | Milestone: 1.0
Component: Documentation | Version: SVN
Resolution: | Keywords: admindoc
Stage: Accepted | Has_patch: 0
Needs_docs: 0 | Needs_tests: 0
Needs_better_patch: 0 |
------------------------------------+---------------------------------------
Comment (by julien):
IMHO, this ticket should be closed as invalid. At least, I don't think it
should be under the 1.0 milestone. Since Jacob has already accepted it, I
won't resolve the ticket myself and I'll just add some comments below.
As far as I can see, admindocs is not described anywhere in the doc,
including the refactored one. It only referenced in the tutorial2 (and in
fact, not even directly) and in the project template's `settings.py`.
That application, as other contrib apps, would deserve a whole page for
itself. But at this stage I see no purpose for specifying the necessity to
include the app in INSTALLED_APPS. That's a trivial information that would
attract too much attention to admindocs in the tutorial.
So, I'd close this ticket as invalid. Then, for whoever's interested to
work on the docs:
- Create a new one with a patch adding a new page that explains what
admindocs is about.
- Finally, add a link in the 'Add-on (“contrib”) applications' section to
that new page.
The same thing should eventually be done for every contrib apps.
--
Ticket URL: <http://code.djangoproject.com/ticket/8496#comment:2>
Django Code <http://code.djangoproject.com/>
The web framework for perfectionists with deadlines
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---
