Opened 5 years ago

Closed 5 years ago

#16209 closed New feature (fixed)

Add alternative repositories to 'Installing the development version' in the docs.

Reported by: ShawnMilo Owned by: ShawnMilo
Component: Documentation Version: 1.3
Severity: Normal Keywords:
Cc: Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description

https://docs.djangoproject.com/en/dev/topics/install/#installing-development-version

The current page only refers to the subversion repo, but there are official github and bitbucket repos which some users will find more convenient.

Attachments (3)

19209_alt_repos.diff (2.0 KB) - added by ShawnMilo 5 years ago.
Patch to mention git & hg as alternatives to svn when "tracking trunk."
16209_alt_repos_2.diff (2.2 KB) - added by ShawnMilo 5 years ago.
Updated patch addressing aaugustin's comments.
16209_alt_repos_3.diff (2.3 KB) - added by bedmondmark 5 years ago.
Updated the patch to reflect jezdez's comments.

Download all attachments as: .zip

Change History (12)

comment:1 Changed 5 years ago by Aymeric Augustin

Needs documentation: unset
Needs tests: unset
Patch needs improvement: unset
Triage Stage: UnreviewedAccepted

comment:2 Changed 5 years ago by ShawnMilo

Owner: changed from nobody to ShawnMilo

Changed 5 years ago by ShawnMilo

Attachment: 19209_alt_repos.diff added

Patch to mention git & hg as alternatives to svn when "tracking trunk."

comment:3 Changed 5 years ago by ShawnMilo

Has patch: set

Patch added. I built the docs (html only) and checked to make sure it looked right and the links worked. I also added myself to AUTHORS since I have a handful of patches in. _

Version 0, edited 5 years ago by ShawnMilo (next)

comment:4 Changed 5 years ago by Aymeric Augustin

Patch needs improvement: set

I think it would be useful to explain that svn is the master, and that hg and git are official mirrors, updated every XXX minutes / hours (I don't know the details).

Very minor: the coding style is to put a space between the # and the comment: #subversion ==> # subversion, etc.

Changed 5 years ago by ShawnMilo

Attachment: 16209_alt_repos_2.diff added

Updated patch addressing aaugustin's comments.

comment:5 Changed 5 years ago by ShawnMilo

Patch needs improvement: unset

Notes by aaugustin addressed, although I would welcome specifics about the delay in updating the DVCS mirrors to enhance the documentation.

comment:6 Changed 5 years ago by Jannis Leidel

Patch needs improvement: set
Type: UncategorizedNew feature

Two things:

  • Don't list the mirrors next to the Subversion repo since it will lead to people thinking they are equal to the SVN repo.
  • Put a big fat warning to the list of mirrors that they aren't guaranteed to be up-to-date since they are hosted on externals services.

Also, the mirrors are updated every 5 minutes.

Changed 5 years ago by bedmondmark

Attachment: 16209_alt_repos_3.diff added

Updated the patch to reflect jezdez's comments.

comment:7 Changed 5 years ago by bedmondmark

Patch needs improvement: unset

Notes by jezdez now addressed.

comment:8 Changed 5 years ago by Jannis Leidel

Triage Stage: AcceptedReady for checkin

comment:9 Changed 5 years ago by Jannis Leidel

Resolution: fixed
Status: newclosed

In [16460]:

Fixed #16209 -- Added notes about the DVCS mirrors to the install docs. Thanks, bedmondmark.

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