[Django] #27711: Questionable "Install Django" option ordering
Django
------------------------------------------------+------------------------
Reporter: Razzi Abuissa | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: master
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
------------------------------------------------+------------------------
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?
--
Ticket URL: <https://code.djangoproject.com/ticket/27711>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
Django
Reporter: Razzi Abuissa | Owner: nobody
Cleanup/optimization |
Component: Documentation | Version: master
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:"991cd69621f95acd2192ac62a08eb139d3e22215" 991cd696]:
{{{
#!CommitTicketReference repository=""
revision="991cd69621f95acd2192ac62a08eb139d3e22215"
Fixed #27711 -- Demoted "Installing a distribution-specific package" in
install intro.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/27711#comment:1>
Django
Reporter: Razzi Abuissa | Owner: nobody
Cleanup/optimization |
Component: Documentation | Version: master
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:"5ea2228731674a913790b4a3ab4ca0669843005f" 5ea22287]:
{{{
#!CommitTicketReference repository=""
revision="5ea2228731674a913790b4a3ab4ca0669843005f"
[1.10.x] Fixed #27711 -- Demoted "Installing a distribution-specific
package" in install intro.
Backport of 991cd69621f95acd2192ac62a08eb139d3e22215 from master
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/27711#comment:2>
Django
Reporter: Razzi Abuissa | Owner: nobody
Cleanup/optimization |
Component: Documentation | Version: master
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):
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.
--
Ticket URL: <https://code.djangoproject.com/ticket/27711#comment:3>