Opened 9 years ago
Last modified 9 years ago
#25398 closed Cleanup/optimization
Static Files Documentation — at Initial Version
Reported by: | Aaron | Owned by: | nobody |
---|---|---|---|
Component: | Documentation | Version: | 1.8 |
Severity: | Normal | Keywords: | |
Cc: | Triage Stage: | Accepted | |
Has patch: | yes | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | yes | UI/UX: | no |
Description
It has come to my attention while using the django documentation that several examples and directions specify the use of paths or os.path.join use the default BASE_DIR and a path written like "directory/subDirectory". I think this confuses a number of people who develop on windows platforms because it is actually more ideal to use os.path.join like this:
os.path.join(BASE_DIR, "directory", "subDirectory")
If you change this within your documentation it might help users who are having problems configuring django with various paths in their applications while also understanding the functionality of os.path better.