QuerySet method docs headings contain entire method signatures

[Gabriel Hurley]

Take a look at this URL (the URL itself, not the page):

​http://docs.djangoproject.com/en/dev/ref/models/querysets/#extra-select-none-where-none-params-none-tables-none-order-by-none-select-params-none

Basically, the headings for the QuerySet methods (and consequently the hash for the anchors in the URLs) contain the entire method signature. This is completely non-functional (as opposed to the :method: declarations directly beneath the headings), it adds unnecessary detail to the page's TOC, and it makes the URLs for those anchors unbearably long/cluttered.

As such, the headings for those methods should all be reduced to simply the name of the method, leaving the method signature defined below.

It looks like the duplication stems from the headings having been written first, and left in place as-is after the method directives were added.

The only downside to fixing this is that any existing external links directly to one of these anchors would now go to top of the page rather than directly to the section within the page.

[Adam Vandenberg]

Update queryset headers on page (haven't checked cross-links yet)

[Adam Vandenberg]

Updated patch.

[Adam Vandenberg]

(Patch is ready for review.)

[Tim Graham]

(In [14737]) Fixed #14758 - Remove entire method signatures from QuerySet headings - thanks adamv for the patch.

[Tim Graham]

(In [14738]) Fixed #14758 - Remove entire method signatures from QuerySet headings - thanks adamv for the patch.

Backport of r14737 from trunk.

[Jacob]

Milestone 1.3 deleted