#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: new
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: tutorial | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1
Easy pickings: 1 | UI/UX: 0
--------------------------------------+------------------------------------
Changes (by Natalia Bidart):
* resolution: wontfix =>
* status: closed => new
Old description:
> The tutorial instructs you to make a `mysite` directory and in that
> directory make another one with the same name. We could resolve this
> confusion by changing the `start project` command from : `django-admin
> startproject mysite` to `django-admin startproject mysite
> djangotutorial`. That way it becomes clear to which directory the
> tutorial is referring to.
>
> There was a ticket #22042 (confused in tutorial 03 about location of
> mysite/urls.py) that has already been closed, but maybe this solution
> will be beneficial.
>
> refferance to the turorial:
> https://docs.djangoproject.com/en/dev/intro/tutorial01/#creating-a-project
New description:
The tutorial instructs you to make a `mysite` directory and in that
directory make another one with the same name. We could resolve this
confusion by changing the `start project` command from : `django-admin
startproject mysite` to `django-admin startproject mysite djangotutorial`.
That way it becomes clear to which directory the tutorial is referring to.
There was a ticket #22042 (confused in tutorial 03 about location of
mysite/urls.py) that has already been closed, but maybe this solution will
be beneficial.
Reference to the tutorial:
https://docs.djangoproject.com/en/dev/intro/tutorial01/#creating-a-project
--
Comment:
After some further thinking, and considering all the discussion that took
place during the Improving the Intro Documentation workshop at DjangoCon
Europe, I think that this ticket is worth pursuing. I'm re-opening to
iterate over the [https://github.com/django/django/pull/18235 PR that Meta
submitted].
--
Ticket URL: <https://code.djangoproject.com/ticket/35502#comment:9>
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/010701912dbd4c39-7eeffe26-43c0-4d82-ba87-f3781feafc25-000000%40eu-central-1.amazonses.com.
