Opened 13 years ago

Closed 13 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 13 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 13 years ago.
Updated patch addressing aaugustin's comments.
16209_alt_repos_3.diff (2.3 KB ) - added by bedmondmark 13 years ago.
Updated the patch to reflect jezdez's comments.

Download all attachments as: .zip

Change History (12)

comment:1 by Aymeric Augustin, 13 years ago

Triage Stage: UnreviewedAccepted

comment:2 by ShawnMilo, 13 years ago

Owner: changed from nobody to ShawnMilo

by ShawnMilo, 13 years ago

Attachment: 19209_alt_repos.diff added

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

comment:3 by ShawnMilo, 13 years ago

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.

Edit: I misnamed the patch. I would upload a correct one but it really doesn't matter and I can't delete the original. Oops.

Last edited 13 years ago by ShawnMilo (previous) (diff)

comment:4 by Aymeric Augustin, 13 years ago

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.

by ShawnMilo, 13 years ago

Attachment: 16209_alt_repos_2.diff added

Updated patch addressing aaugustin's comments.

comment:5 by ShawnMilo, 13 years ago

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 by Jannis Leidel, 13 years ago

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.

by bedmondmark, 13 years ago

Attachment: 16209_alt_repos_3.diff added

Updated the patch to reflect jezdez's comments.

comment:7 by bedmondmark, 13 years ago

Patch needs improvement: unset

Notes by jezdez now addressed.

comment:8 by Jannis Leidel, 13 years ago

Triage Stage: AcceptedReady for checkin

comment:9 by Jannis Leidel, 13 years ago

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