Commit Graph

145 Commits

Author SHA1 Message Date
Adam Johnson d17b380653 Refs #30573 -- Rephrased "Of Course" and "Obvious(ly)" in documentation and comments. 2020-05-04 12:10:47 +02:00
Greg Kaleka 5d2f5dd4cc Doc'd Meta inheritance from abstract parents. 2020-05-01 07:48:50 +02:00
Matheus Cunha Motta 0352a44dd6 Fixed #31303 -- Removed outdated note about symmetrical intermediate table for self-referential ManyToManyField.
Follow up to 87b1ad6e73.
2020-02-24 08:26:29 +01:00
Mariusz Felisiak d202846ced
Refs #29998 -- Corrected auto-created OneToOneField parent_link in MTI docs. 2020-01-15 15:07:07 +01:00
Tobias Kunze 4a954cfd11 Fixed #30573 -- Rephrased documentation to avoid words that minimise the involved difficulty.
This patch does not remove all occurrences of the words in question.
Rather, I went through all of the occurrences of the words listed
below, and judged if they a) suggested the reader had some kind of
knowledge/experience, and b) if they added anything of value (including
tone of voice, etc). I left most of the words alone. I looked at the
following words:

- simply/simple
- easy/easier/easiest
- obvious
- just
- merely
- straightforward
- ridiculous

Thanks to Carlton Gibson for guidance on how to approach this issue, and
to Tim Bell for providing the idea. But the enormous lion's share of
thanks go to Adam Johnson for his patient and helpful review.
2019-09-06 13:27:46 +02:00
Shai Berger 72ebe85a26 Fixed #27910 -- Added enumeration helpers for use in Field.choices.
These classes can serve as a base class for user enums, supporting
translatable human-readable names, or names automatically inferred
from the enum member name.

Additional properties make it easy to access the list of names, values
and display labels.

Thanks to the following for ideas and reviews:

Carlton Gibson, Fran Hrženjak, Ian Foote, Mariusz Felisiak, Shai Berger.

Co-authored-by: Shai Berger <shai@platonix.com>
Co-authored-by: Nick Pope <nick.pope@flightdataservices.com>
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2019-09-04 14:42:49 +02:00
Meysam 833878411c Fixed typo in docs/topics/db/models.txt. 2019-06-24 09:04:33 +02:00
Caio Ariede 5248abe9b0 Fixed #30505 -- Doc'd how changes in the order of Field.choices affect migrations. 2019-06-04 14:11:41 +02:00
Jon Dufresne e86cc14bd3 Changed docs to link to Python's description of iterable. 2019-05-17 17:27:19 +02:00
Jon Dufresne 97d3321e89 Changed tuple choices to list in docs. 2019-05-15 14:31:42 +02:00
Collin Anderson 769355c765 Fixed #9475 -- Allowed RelatedManager.add(), create(), etc. for m2m with a through model. 2019-01-15 11:12:17 -05:00
François Freitag 9b15ff08ba Used auto-numbered lists in documentation. 2018-11-15 13:54:28 -05:00
Jon Dufresne 8c3e0eb1c1 Normalized spelling of "lowercase" and "lowercased". 2018-09-25 10:30:18 -04:00
Tim Graham d483a5f0dc Fixed #29756 -- Doc'd that model field names can't end with an underscore. 2018-09-14 11:38:39 -04:00
Curtis Maloney c49ea6f591 Refs #20910 -- Replaced snippet directive with code-block. 2018-09-10 13:00:34 -04:00
ovalseven8 22bcd3a1d8 Fixed #29192 -- Corrected docs regarding overriding fields from abstract base classes. 2018-03-13 12:45:01 -04:00
LeeHanYeong 3ffbd54566 Removed incorrect reference to ModelChoiceField in Field.choices docs. 2017-10-13 10:37:04 -04:00
Jeremy Satterfield 473ab4610e Fixed #28332 -- Fixed diamond inheritence example in docs. 2017-09-02 14:10:41 -04:00
Irindu Indeera babe9e64a6 Fixed #28352 -- Corrected QuerySet.values_list() return type in docs examples. 2017-07-11 14:15:17 -04:00
Simon Charette 0ad7e8f71f Fixed #28003 -- Doc'd what an auto-created OneToOneField parent_link looks like.
Thanks Simon Charette for the draft patch.
2017-04-01 21:21:15 -04:00
Mariusz Felisiak a3af8c99d9 Removed extra characters in docs header underlines. 2017-03-20 18:30:32 -04:00
Vytis Banaitis d1bab24e01 Refs #23919, #27778 -- Removed obsolete mentions of unicode. 2017-01-26 08:19:27 -05:00
chillaranand dc165ec8e5 Refs #23919 -- Replaced super(ClassName, self) with super() in docs. 2017-01-25 11:53:05 -05:00
Tim Graham f6acd1d271 Refs #23919 -- Removed Python 2 notes in docs. 2017-01-18 11:51:29 -05:00
Tim Graham e27e4c0339 Removed versionadded/changed annotations for 1.10. 2017-01-17 20:52:05 -05:00
Maxime Lorant 241e1e3cd7 Removed SHOUTING in doc examples. 2017-01-09 17:00:44 -05:00
Tim Graham 3ce212a23c Fixed #27494 -- Fixed typos in docs/topics/db/models.txt. 2016-11-16 07:28:20 -05:00
Jonatas CD e8728f03f0 Refs #11078 -- Doc'd Meta inheritance in proxy models. 2016-10-04 19:53:24 -04:00
Berker Peksag a02b5848ae Replaced property() usage with decorator in several places. 2016-08-25 20:06:22 -04:00
Evan Palmer 84d8d1d715 Fixed #25127 -- Documented how to organize models in a package. 2016-06-04 11:47:55 -04:00
Loïc Bistuer 3a47d42fa3 Fixed #20932, #25897 -- Streamlined manager inheritance. 2016-05-17 02:29:22 +07:00
Aron Podrigal 85ef98dc6e Fixed #24305 -- Allowed overriding fields on abstract models.
Fields inherited from abstract base classes may be overridden like
any other Python attribute. Inheriting from multiple models/classes
with the same attribute name will follow the MRO.
2016-05-16 07:32:21 -04:00
Tim Graham af69c9113c Fixed typo in docs/topics/db/models.txt 2016-05-13 15:18:33 -04:00
Akshesh 49f95cc0a0 Fixed #11560 -- Allowed proxy model multiple-inheritance from the same concrete base model. 2016-03-30 13:06:27 -04:00
Tim Graham 22d2a5b00a Corrected a run on sentence in doc/topics/db/models.txt. 2016-02-25 14:22:41 -05:00
Becka R cf48962b36 Clarified "database column type" explanation. 2016-02-11 18:26:46 -05:00
Tim Graham 8ce8beb3f2 Unified some doc links to OneToOneField and ManyToManyField. 2016-02-01 11:02:26 -05:00
rowanv a6ef025dfb Fixed #26124 -- Added missing code formatting to docs headers. 2016-02-01 10:42:05 -05:00
James Pulec f05722a08a Fixed #25354 -- Added class/app_label interpolation for related_query_name. 2016-01-28 11:10:47 -05:00
Tim Graham 98839e9066 Removed British/Austrialian word: whilist. 2015-12-31 14:29:52 -05:00
bphillips d508326e2f Fixed #25672 -- Clarified why related ManyToManyFields with a custom intermediate model disable the remove() method. 2015-12-08 18:00:10 -05:00
Tomasz Anielak b67502fb8d Fixed typo in docs/topics/db/models.txt. 2015-10-31 08:53:00 -04:00
Tim Graham 9c5e272860 Fixed #25550 -- Deprecated direct assignment to the reverse side of a related set. 2015-10-27 07:57:15 -04:00
Tim Graham e0837f2cb1 Fixed #25508 -- Modified QuerySet.__repr__() to disambiguate it from a list. 2015-10-06 12:38:34 -04:00
David Sanders 5c6316dc34 Clarified that Model.delete() isn't called as a result of a cascading delete. 2015-09-30 08:44:04 -04:00
Tim Graham de99f558d8 Fixed #25462 -- Removed Model.__unicode__() in favor of @python_2_unicode_compatible. 2015-09-25 13:28:12 -04:00
Flavio Curella c2e70f0265 Fixed #21127 -- Started deprecation toward requiring on_delete for ForeignKey/OneToOneField 2015-07-27 18:28:13 -04:00
Marco Santamaria bae72bdd2a Fixed #11078 -- documentation update. 2015-04-19 16:24:14 +02:00
darkryder 9ec8aa5e5d Fixed #24149 -- Normalized tuple settings to lists. 2015-02-03 14:59:45 -05:00
Tim Graham c79faae761 Removed versionadded/changed notes for 1.7. 2015-02-01 21:02:40 -05:00