Opened 15 years ago

Closed 15 years ago

#10218 closed (fixed)

Unnecessary quotes in serialization documentation

Reported by: thedaniel Owned by: nobody
Component: Documentation Version: 1.0
Severity: Keywords:
Cc: Triage Stage: Unreviewed
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

The serialization docs say:

Django "ships" with a few included serializers:

The quotes imply Django either a) doesn't ship (the stigma of which we've hopefully escaped by releasing 1.0) or b) that this usage of "ship" is a self-conscious use of vernacular. As this use of "to ship" is common in the software world, and we do actually ship, the quotes are not necessary. Patch attached.

Attachments (1)

no-quotes.diff (479 bytes ) - added by thedaniel 15 years ago.
no quotes!

Download all attachments as: .zip

Change History (3)

by thedaniel, 15 years ago

Attachment: no-quotes.diff added

no quotes!

comment:1 by James Bennett, 15 years ago

I could be wrong, but I believe part of the reason for this is that the serializers themselves are only part of the equation: some of them require third-party Python modules before they actually work. Therefore Django "ships" the serializer, but you may still need other software before you can use it in practice (and the modules you'll need are documented).

comment:2 by Adrian Holovaty, 15 years ago

Resolution: fixed
Status: newclosed

(In [9850]) Fixed #10218 -- Reworded serialization.txt sentence to remove awkward quotes. Thanks for bringing this up, thedaniel

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