Opened 13 years ago
Closed 10 years ago
#17044 closed New feature (wontfix)
Add "project layout and python path" page to documentation
Reported by: | Carl Meyer | Owned by: | nobody |
---|---|---|---|
Component: | Documentation | Version: | dev |
Severity: | Normal | Keywords: | |
Cc: | Triage Stage: | Accepted | |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description
It would be good to have a page in the docs that explains in a bit more detail why the default "startproject" layout is the way it is, how the python path gets set correctly so that it works (e.g. by "script directory" if you use manage.py, "current directory" otherwise), what directory should be manually added to sys.path in environments where neither of those apply, where you put packages in the layout if you want them to be top-level and where you put them if they should be inside the project package, etc. Some of this information is in the 1.4 release notes, there's a bunch more discussed in [this mailing list thread http://groups.google.com/group/django-developers/browse_frm/thread/44b70a37ff73298b].
Change History (2)
comment:1 by , 10 years ago
comment:2 by , 10 years ago
Resolution: | → wontfix |
---|---|
Status: | new → closed |
Maybe obsolete. Reopen if you have a more concrete proposal.
Looks like the proposed solution in that google groups thread has been implemented in later versions. The default project structure now is -