#4355: Confusing example in documentation for url template tag
-------------------------------------------------+--------------------------
Reporter: Collin Grady <[EMAIL PROTECTED]> | Owner: jacob
Status: closed | Component:
Documentation
Version: SVN | Resolution: fixed
Keywords: | Stage: Ready
for checkin
Has_patch: 1 | Needs_docs: 0
Needs_tests: 0 | Needs_better_patch: 0
-------------------------------------------------+--------------------------
Comment (by mtredinnick):
The first line is in the app dir, the second line is in the project's URL
conf -- that is clear in the example -- so both have their own directory
in their effective Python import path. The docs say "if is is included
like this", setting up the precondition. It doesn't say you have to import
it like that. We are not spoon-feeding here, intentionally; that drags
down the quality of the docs for the other 90% of readers. If somebody
need to stop and think for a minute to get the example straight, no harm
is done.
There really are far more important problems to fix than going around and
around on this. Let's move on, please.
--
Ticket URL: <http://code.djangoproject.com/ticket/4355#comment:10>
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
-~----------~----~----~----~------~----~------~--~---
