#35502: In the tutorial we have two mysite directories, and we often see users
confused by that.
--------------------------------------+------------------------------------
     Reporter:  Meta Petric           |                    Owner:  tabiva
         Type:  Cleanup/optimization  |                   Status:  closed
    Component:  Documentation         |                  Version:  dev
     Severity:  Normal                |               Resolution:  wontfix
     Keywords:  tutorial              |             Triage Stage:  Accepted
    Has patch:  1                     |      Needs documentation:  0
  Needs tests:  0                     |  Patch needs improvement:  1
Easy pickings:  1                     |                    UI/UX:  0
--------------------------------------+------------------------------------
Comment (by Natalia Bidart):

 I've been investigating other resources to check what they do, and I think
 there is enough variation/confusion that we should take a stance and
 improve our tutorial. Some links showing how `startproject` is used:

 * [https://realpython.com/django-setup/ Your First Steps With Django: Set
 Up a Django Project] uses `django-admin startproject setup` but it has a
 long and arguably confusing/distracting note about why the duplicated
 `setup` folder
 * [https://realpython.com/get-started-with-django-1/ Get Started With
 Django: Build a Portfolio App] uses `django-admin startproject
 personal_portfolio .` but it needs to clarify that ''Don’t forget to add
 the dot (.) at the end of the command above. '' since it can be easily
 missed.
 * [https://tutorial.djangogirls.org/en/django_start_project/ Django Girls
 Tutorial: Your first Django project!] uses `django-admin startproject
 mysite .` and it also needs to clarify how crucial the dot is.

 I'll go back to the first PR created for this issue and review with this
 in mind, will post updates afterwards.
-- 
Ticket URL: <https://code.djangoproject.com/ticket/35502#comment:8>
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 view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/010701902e46420e-fd53b8ee-313b-4d75-a4a6-8edd53edc0a5-000000%40eu-central-1.amazonses.com.

Reply via email to