[Django] #26032: Where does `manage.py` belong: to Application or to Project?

2 views
Skip to first unread message

Django

unread,
Jan 4, 2016, 5:07:28 AM1/4/16
to django-...@googlegroups.com
#26032: Where does `manage.py` belong: to Application or to Project?
--------------------------------------+--------------------
Reporter: guettli | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: 1.9
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
--------------------------------------+--------------------
First: Thanks to Tim Graham for fixing the "app vs project" issue
(https://code.djangoproject.com/ticket/25748)

Here is the current part about "application":

{{{
The term **application** describes a Python package that provides some set
of
features. Applications :doc:`may be reused </intro/reusable-apps/>` in
various
projects. A project's root directory (the one that contains ``manage.py``)
is
usually the container for all of a project's applications which aren't
installed separately.
}}}

Where does "manage.py" belong? to Application or to Project?

My personal point of view is that it belongs to "project", since there can
only be one script with this name.

I think the above part in the docs needs to be improved. Maybe just move
the sentence to the previous part.

--
Ticket URL: <https://code.djangoproject.com/ticket/26032>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Jan 4, 2016, 7:57:29 AM1/4/16
to django-...@googlegroups.com
#26032: Where does `manage.py` belong: to Application or to Project?
-------------------------------------+-------------------------------------
Reporter: guettli | Owner: nobody
Type: | Status: new
Cleanup/optimization |
Component: Documentation | Version: 1.9
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 timgraham):

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


Comment:

We could move it as you suggest, but I thought it makes sense to introduce
what an application is before discussing them (such as where they are
located) in much detail. Does anyone else find the current version
unclear?

--
Ticket URL: <https://code.djangoproject.com/ticket/26032#comment:1>

Django

unread,
Jan 4, 2016, 8:28:39 AM1/4/16
to django-...@googlegroups.com
#26032: Where does `manage.py` belong: to Application or to Project?
-------------------------------------+-------------------------------------
Reporter: guettli | Owner: nobody
Type: | Status: new
Cleanup/optimization |
Component: Documentation | Version: 1.9
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
-------------------------------------+-------------------------------------

Comment (by guettli):

Hmmm chicken-egg problem. I like the dictionary style:

A: ... definition of A

B: ... definition of B.

I think forward references are ok.

--
Ticket URL: <https://code.djangoproject.com/ticket/26032#comment:2>

Django

unread,
Jan 4, 2016, 10:55:41 AM1/4/16
to django-...@googlegroups.com
#26032: Where does `manage.py` belong: to Application or to Project?
-------------------------------------+-------------------------------------
Reporter: guettli | Owner: nobody
Type: | Status: closed
Cleanup/optimization |
Component: Documentation | Version: 1.9
Severity: Normal | Resolution: fixed
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 Tim Graham <timograham@…>):

* status: new => closed
* resolution: => fixed


Comment:

In [changeset:"0a72ad3952c0a2e335ed8518d31647e6536ee3fe" 0a72ad3]:
{{{
#!CommitTicketReference repository=""
revision="0a72ad3952c0a2e335ed8518d31647e6536ee3fe"
[1.9.x] Fixed #26032 -- Moved "project root directory" to a separate
paragraph.

Backport of b07f91600d61a2f8d58adb4c92d36dd0b2b34fe7 from master
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/26032#comment:3>

Django

unread,
Jan 4, 2016, 10:55:47 AM1/4/16
to django-...@googlegroups.com
#26032: Where does `manage.py` belong: to Application or to Project?
-------------------------------------+-------------------------------------
Reporter: guettli | Owner: nobody
Type: | Status: closed
Cleanup/optimization |
Component: Documentation | Version: 1.9
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage:
| Unreviewed

Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Comment (by Tim Graham <timograham@…>):

In [changeset:"b07f91600d61a2f8d58adb4c92d36dd0b2b34fe7" b07f916]:
{{{
#!CommitTicketReference repository=""
revision="b07f91600d61a2f8d58adb4c92d36dd0b2b34fe7"


Fixed #26032 -- Moved "project root directory" to a separate paragraph.
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/26032#comment:4>

Django

unread,
Jan 5, 2016, 11:04:35 AM1/5/16
to django-...@googlegroups.com
#26032: Where does `manage.py` belong: to Application or to Project?
-------------------------------------+-------------------------------------
Reporter: guettli | Owner: nobody
Type: | Status: closed
Cleanup/optimization |
Component: Documentation | Version: 1.9
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage:
| Unreviewed

Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Comment (by guettli):

thank you

--
Ticket URL: <https://code.djangoproject.com/ticket/26032#comment:5>

Django

unread,
Jan 28, 2016, 3:11:27 AM1/28/16
to django-...@googlegroups.com
#26032: Where does `manage.py` belong: to Application or to Project?
-------------------------------------+-------------------------------------
Reporter: guettli | Owner: nobody
Type: | Status: closed
Cleanup/optimization |
Component: Documentation | Version: 1.9
Severity: Normal | Resolution: fixed
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 TZanke):

* cc: tzanke@… (added)


--
Ticket URL: <https://code.djangoproject.com/ticket/26032#comment:6>

Reply all
Reply to author
Forward
0 new messages