Opened 3 years ago

#17044 new New feature

Add "project layout and python path" page to documentation

Reported by: carljm Owned by: nobody
Component: Documentation Version: master
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


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, "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].

Attachments (0)

Change History (0)

Add Comment

Modify Ticket

Change Properties
<Author field>
as new
The owner will be changed from nobody to anonymous. Next status will be 'assigned'
as The resolution will be set. Next status will be 'closed'

E-mail address and user name can be saved in the Preferences.

Note: See TracTickets for help on using tickets.