Opened 8 years ago

Closed 8 years ago

Last modified 8 years ago

#26032 closed Cleanup/optimization (fixed)

Where does `manage.py` belong: to Application or to Project?

Reported by: Thomas Güttler Owned by: nobody
Component: Documentation Version: 1.9
Severity: Normal Keywords:
Cc: tzanke@… Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

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.

Change History (6)

comment:1 by Tim Graham, 8 years ago

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?

comment:2 by Thomas Güttler, 8 years ago

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

A: ... definition of A

B: ... definition of B.

I think forward references are ok.

comment:3 by Tim Graham <timograham@…>, 8 years ago

Resolution: fixed
Status: newclosed

In 0a72ad3:

[1.9.x] Fixed #26032 -- Moved "project root directory" to a separate paragraph.

Backport of b07f91600d61a2f8d58adb4c92d36dd0b2b34fe7 from master

comment:4 by Tim Graham <timograham@…>, 8 years ago

In b07f916:

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

comment:5 by Thomas Güttler, 8 years ago

thank you

comment:6 by TZanke, 8 years ago

Cc: tzanke@… added
Note: See TracTickets for help on using tickets.
Back to Top