#14426: Factor "mysite" out of all code example import statements
------------------------------------+---------------------------------------
Reporter: gabrielhurley | Owner: gabrielhurley
Status: assigned | Milestone: 1.3
Component: Documentation | Version: 1.2
Resolution: | Keywords:
Stage: Accepted | Has_patch: 1
Needs_docs: 0 | Needs_tests: 0
Needs_better_patch: 0 |
------------------------------------+---------------------------------------
Comment (by gabrielhurley):
I had looked at a number of the items changed in the latest patch, and
consciously decided not to change them for the following reason:
On a practical level, you can't really have reusable projects, so it isn't
as harmful to include "mysite" in front of project-level modules (e.g.
mysite.views, or mysite.urls), and in these cases it would be much more
confusing to new users of Django to just see a line like "`from views
import archive, about, contact`" in the docs. There wouldn't be any clear
indication of which "views" we're talking about.
So even though it's perfectly valid to drop the "mysite" from those cases
if you know what you're doing, I'm going to intentionally leave them in
for the sanity of newbies ;-)
--
Ticket URL: <http://code.djangoproject.com/ticket/14426#comment:5>
Django <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 django-upda...@googlegroups.com.
To unsubscribe from this group, send email to
django-updates+unsubscr...@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en.
