Opened 7 years ago

Closed 7 years ago

Last modified 7 years ago

#27711 closed Cleanup/optimization (fixed)

Questionable "Install Django" option ordering

Reported by: Razzi Abuissa Owned by: nobody
Component: Documentation Version: dev
Severity: Normal Keywords:
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

In the "Install Django" section of the docs (https://docs.djangoproject.com/en/1.10/intro/install/), 3 options are given to install Django:

You’ve got three easy options to install Django:

  • Install a version of Django provided by your operating system distribution. This is the quickest option for those who have operating systems that distribute Django.
  • Install an official release. This is the best approach for most users.
  • Install the latest development version. This option is for enthusiasts who want the latest-and-greatest features and aren’t afraid of running brand new code. You might encounter new bugs in the development version, but reporting them helps the development of Django. Also, releases of third-party packages are less likely to be compatible with the development version than with the latest stable release.

First of all, I'm confused as to why "the best approach for most users" is 2nd in the list. I think it should be first.

Second, I have never used an operating system distribution of Django, and I expect they lag behind the official releases. Using pip has always worked for me. I would like to pose the question: should we recommend installing operating system Django distributions at all?

Change History (3)

comment:1 by Tim Graham <timograham@…>, 7 years ago

Resolution: fixed
Status: newclosed

In 991cd696:

Fixed #27711 -- Demoted "Installing a distribution-specific package" in install intro.

comment:2 by Tim Graham <timograham@…>, 7 years ago

In 5ea22287:

[1.10.x] Fixed #27711 -- Demoted "Installing a distribution-specific package" in install intro.

Backport of 991cd69621f95acd2192ac62a08eb139d3e22215 from master

comment:3 by Tim Graham, 7 years ago

Thanks, I reordered as suggested. About removing the distribution packages instructions, you could raise that idea on the DevelopersMailingList for discussion. I'm not sure how often that's used.

Note: See TracTickets for help on using tickets.
Back to Top