Code

Opened 3 years ago

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

Download all attachments as: .zip

Change History (12)

comment:1 Changed 3 years ago by aaugustin

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Triage Stage changed from Unreviewed to Accepted

comment:2 Changed 3 years ago by ShawnMilo

  • Owner changed from nobody to ShawnMilo

Changed 3 years ago by ShawnMilo

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

comment:3 Changed 3 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.

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 3 years ago by ShawnMilo (previous) (diff)

comment:4 Changed 3 years ago by aaugustin

  • 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 3 years ago by ShawnMilo

Updated patch addressing aaugustin's comments.

comment:5 Changed 3 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 3 years ago by jezdez

  • Patch needs improvement set
  • Type changed from Uncategorized to New 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 3 years ago by bedmondmark

Updated the patch to reflect jezdez's comments.

comment:7 Changed 3 years ago by bedmondmark

  • Patch needs improvement unset

Notes by jezdez now addressed.

comment:8 Changed 3 years ago by jezdez

  • Triage Stage changed from Accepted to Ready for checkin

comment:9 Changed 3 years ago by jezdez

  • Resolution set to fixed
  • Status changed from new to closed

In [16460]:

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

Add Comment

Modify Ticket

Change Properties
<Author field>
Action
as closed
as The resolution will be set. Next status will be 'closed'
The resolution will be deleted. Next status will be 'new'
Author


E-mail address and user name can be saved in the Preferences.

 
Note: See TracTickets for help on using tickets.