#25398: Static Files Documentation
-------------------------------+--------------------------------------
     Reporter:  amrosado       |                    Owner:  nobody
         Type:  Uncategorized  |                   Status:  new
    Component:  Documentation  |                  Version:  1.8
     Severity:  Normal         |               Resolution:
     Keywords:                 |             Triage Stage:  Unreviewed
    Has patch:  0              |      Needs documentation:  0
  Needs tests:  0              |  Patch needs improvement:  0
Easy pickings:  0              |                    UI/UX:  0
-------------------------------+--------------------------------------
Changes (by mlorant):

 * needs_better_patch:   => 0
 * needs_tests:   => 0
 * needs_docs:   => 0


Old 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.

New 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.

--

--
Ticket URL: <https://code.djangoproject.com/ticket/25398#comment:1>
Django <https://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 unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/066.b25597abf2677c50b27062992e3da3fe%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to