Opened 16 years ago

Closed 16 years ago

Last modified 13 years ago

#8701 closed (fixed)

Fix references to old doc

Reported by: Julien Phalip Owned by: Jacob
Component: Documentation Version: dev
Severity: Keywords:
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

I've counted 33 references to the old doc (http://www.djangoproject.com/documentation), either in the code or in the refactored doc.
Those should be fixed before release.

Attachments (3)

8701.diff (3.8 KB ) - added by Thejaswi Puthraya 16 years ago.
removed many documented references, few more to go
8701-v2.diff (9.3 KB ) - added by Richard Barran 16 years ago.
Another patch; more complete.
8701.couple-more-old-doc-refs.diff (871 bytes ) - added by Julien Phalip 16 years ago.

Download all attachments as: .zip

Change History (18)

by Thejaswi Puthraya, 16 years ago

Attachment: 8701.diff added

removed many documented references, few more to go

comment:1 by Thejaswi Puthraya, 16 years ago

Triage Stage: UnreviewedAccepted

Some references still exist to topics like abstract base classes, multi-table inheritance which have not been documented in the new docs.

comment:2 by Thejaswi Puthraya, 16 years ago

#8533 has the list of undocumented features.

comment:3 by patrickf, 16 years ago

hi thejaswi_puthraya, it appears that the patch that you submitted is... faulty. It is prefixed with a/ - so it cannot be applied cleanly.

Is this intentional, and are you intending to go through all of the documentation to clear out all the references to the old docs - as you have not done all yet?

Please advise - or join us on IRC - django-sprint...

thanks... patrickf

comment:4 by Richard Barran, 16 years ago

thejaswi_puthraya: it's worth checking http://www.djangoproject.com/documentation/contributing/#patch-style.

The 'standard' patch style uses svn diff. Your patch was probably created using mercurial/git (thanks cramm for that tip).

comment:5 by Richard Barran, 16 years ago

Owner: changed from nobody to Richard Barran

by Richard Barran, 16 years ago

Attachment: 8701-v2.diff added

Another patch; more complete.

comment:6 by Richard Barran, 16 years ago

Has patch: set

Added a new patch (8701-v2.diff).

This is a longer version of 8701.diff:

  • found more references to old documentation location.
  • I've left alone old-doc references to subjects missing in the new docs (ex: model inheritance).

#8533 covers this subject, changing the links from old doc to new doc should probably be part of a patch for that ticket.
I'm adding a comment to #8533 to remember this task.

  • I've left alone links to 0.96 documentation, as I assume that its location is not changing.

Please correct me if I am wrong!

in reply to:  6 comment:7 by Julien Phalip, 16 years ago

Replying to richardb:

  • I've left alone links to 0.96 documentation, as I assume that its location is not changing.

Please correct me if I am wrong!

Yes, Jacob just confirmed that: "... the old docs will stay where they are; 1.0+ will be in the new place."
http://groups.google.com/group/django-developers/browse_thread/thread/8375d99c2216470f#

comment:8 by Richard Barran, 16 years ago

Owner: Richard Barran removed

comment:9 by Jacob, 16 years ago

Resolution: fixed
Status: newclosed

(In [8857]) Cleaned up a bunch of minor doc stuff:

  • Removed flatpages/redirects README; no other contrib apps have those.
  • Cleaned up top-level README to be more readable.
  • Removed outdated references to old docs (Fixes #8701)

by Julien Phalip, 16 years ago

comment:10 by Julien Phalip, 16 years ago

Resolution: fixed
Status: closedreopened

I spotted a couple more outdated references to the old docs. See the attached patch.

I think those are the last ones, excluding the references to the previous releases (0.95/0.96) and the model examples. Concerning the latter, I'm wondering if that's actually intentional. I've just asked the question on the dev-list: http://groups.google.com/group/django-developers/browse_thread/thread/2b6377bfe5e25170#

comment:11 by Jacob, 16 years ago

In the future please open new tickets in situations like this - it's easy for us to follow what's going on when we don't recycle closed tickets. I'll clean this up today, though; thanks for the patch.

comment:12 by Jacob, 16 years ago

Owner: set to Jacob
Status: reopenednew

comment:13 by Jacob, 16 years ago

Status: newassigned

comment:14 by Jacob, 16 years ago

Resolution: fixed
Status: assignedclosed

(In [8941]) Fixed #8701, a couple of bad links in the docs.

comment:15 by Jacob, 13 years ago

milestone: 1.0

Milestone 1.0 deleted

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