Opened 10 years ago
Last modified 10 years ago
#25398 closed Cleanup/optimization
Static Files Documentation — at Version 1
| 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 (last modified by )
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.