a9337b4add
Used :pep: role in various docs.
2020-05-13 09:14:04 +02:00
6789ded0a6
Fixed #12990 , Refs #27694 -- Added JSONField model field.
...
Thanks to Adam Johnson, Carlton Gibson, Mariusz Felisiak, and Raphael
Michel for mentoring this Google Summer of Code 2019 project and
everyone else who helped with the patch.
Special thanks to Mads Jensen, Nick Pope, and Simon Charette for
extensive reviews.
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2020-05-08 07:23:31 +02:00
d17b380653
Refs #30573 -- Rephrased "Of Course" and "Obvious(ly)" in documentation and comments.
2020-05-04 12:10:47 +02:00
5d2f5dd4cc
Doc'd Meta inheritance from abstract parents.
2020-05-01 07:48:50 +02:00
33f7739108
Fixed #31356 -- Changed IRC links to the Freenode webchat.
2020-04-29 20:08:36 +02:00
fa5e7e46d8
Fixed #31423 -- Clarified nested atomic() example.
2020-04-04 20:39:33 +02:00
f3da09df0f
Fixed #31396 -- Added binary XOR operator to F expressions.
2020-03-25 10:16:30 +01:00
f75af5b67b
Corrected outdated sentence in One-to-one relationships docs.
2020-03-17 10:49:37 +01:00
a2f554249e
Fixed #27865 -- Adjusted docs example to avoid confusion with models.BaseManager.
2020-03-10 09:14:30 +01:00
370628673b
Fixed #31350 -- Fixed typo in docs/topics/db/optimization.txt.
2020-03-09 07:54:25 +01:00
08a6215d33
Fixed #31342 -- Clarified docs about using base managers for related objects.
2020-03-06 11:08:08 +01:00
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
958977f662
Fixed #31212 -- Updated psycopg links to HTTPS and new location.
2020-01-29 06:25:40 +01:00
d202846ced
Refs #29998 -- Corrected auto-created OneToOneField parent_link in MTI docs.
2020-01-15 15:07:07 +01:00
2ea3fb3e63
Removed "Don't do that" from docs and error messages.
...
It's slightly aggressive and doesn't explain itself.
2020-01-06 13:50:43 +01:00
5e00bd1f77
Removed unnecessary code-block directives in various docs.
2019-12-23 14:47:13 +01:00
abc51d44af
Used 🎫 role in all tickets links.
2019-11-26 14:02:24 +01:00
608e06023e
Fixed #27164 -- Fixed an example of using routers in multiple databases docs.
...
Make sure that AuthRouter includes ContentType in the same database.
2019-11-20 11:43:14 +01:00
11e327a3ff
Fixed #30988 -- Deprecated the InvalidQuery exception.
...
It was barely documented without pointers at its defining location and
was abused to prevent misuse of the QuerySet field deferring feature.
2019-11-18 14:06:51 +01:00
6a04e69e68
Fixed #30828 -- Added how to remove/insert many-to-many relations in bulk to the database optimization docs.
2019-11-12 12:44:41 +01:00
367634f976
Replaced 'n_' prefix with 'number_of_' in docs/topics/db/queries.txt.
2019-11-07 09:22:13 +01:00
e5cacb1f47
Refs #30947 -- Changed tuples to lists in model Meta options examples in docs.
...
Follow up to 97d3321e89
2019-11-04 10:20:30 -08:00
a370dbd954
Corrected error message in Many-to-many relationships docs.
2019-10-30 16:17:20 +01:00
35396a7f24
Refs #26207 -- Removed obsolete note about slow constructing a model with deferred fields.
...
This is not true since 7f51876
2019-10-14 12:51:07 +02:00
0ddb4ebf7b
Refs #14357 -- Made Meta.ordering not affect GROUP BY queries.
...
Per deprecation timeline.
2019-09-10 12:01:00 +02:00
416c584cab
Removed versionadded/changed annotations for 2.2.
2019-09-10 12:01:00 +02:00
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
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
cece802dbb
Corrected typo in search docs. ( #11673 )
2019-08-20 10:37:48 +02:00
68aeb90160
Fixed #30656 -- Added QuerySet.bulk_update() to the database optimization docs.
2019-07-29 09:52:29 +02:00
fe33fdc049
Refs #30656 -- Reorganized bulk methods in the database optimization docs.
2019-07-29 09:52:29 +02:00
833878411c
Fixed typo in docs/topics/db/models.txt.
2019-06-24 09:04:33 +02:00
5248abe9b0
Fixed #30505 -- Doc'd how changes in the order of Field.choices affect migrations.
2019-06-04 14:11:41 +02:00
b6c4766f53
Refs #29548 -- Updated docs for MariaDB support.
2019-05-27 19:59:49 +02:00
888fdf182e
Fixed #30419 -- Favored Meta.indexes over Meta.index_together in optimization docs.
2019-05-22 07:34:54 +02:00
e86cc14bd3
Changed docs to link to Python's description of iterable.
2019-05-17 17:27:19 +02:00
97d3321e89
Changed tuple choices to list in docs.
2019-05-15 14:31:42 +02:00
af5ec222cc
Used time.monotonic() instead of time.time() where applicable.
...
time.monotonic() available from Python 3.3:
- Nicely communicates a narrow intent of "get a local system monotonic
clock time" instead of possible "get a not necessarily accurate Unix
time stamp because it needs to be communicated to outside of this
process/machine" when time.time() is used.
- Its result isn't affected by the system clock updates.
There are two classes of time.time() uses changed to time.monotonic()
by this change:
- measuring time taken to run some code.
- setting and checking a "close_at" threshold for for persistent db
connections (django/db/backends/base/base.py).
2019-05-08 18:34:22 +02:00
6fd9c9daa6
Fixed #30365 -- Fixed syntax highlighting in SQL examples.
...
Sphinx interprets some "%[a-z]" in SQL statements as a
"Literal.String.Interpol" which leads to incorrect highlighting.
2019-04-23 12:37:50 +02:00
ba72606760
Fixed #30347 -- Fixed typo in docs/topics/db/aggregation.txt.
2019-04-13 12:35:31 +02:00
198a2a9381
Removed unnecessary /static from links to PostgreSQL docs.
2019-03-29 21:49:44 -04:00
a68c029e22
Used extlinks for Django's source code.
2019-03-28 20:32:17 -04:00
50f09264ae
Refs #29683 -- Updated multi-db docs for view permission.
2019-02-25 14:56:36 -05:00
769355c765
Fixed #9475 -- Allowed RelatedManager.add(), create(), etc. for m2m with a through model.
2019-01-15 11:12:17 -05:00
e817ae74da
Followed style guide for model attribute ordering.
2018-12-27 19:34:14 -05:00
9b15ff08ba
Used auto-numbered lists in documentation.
2018-11-15 13:54:28 -05:00
9886dffdf4
Fixed #29940 -- Recommended using the ORM rather than raw SQL.
2018-11-13 18:15:24 -05:00
a1ffbfb801
Removed unused fields from aggregation docs.
2018-10-13 21:13:45 -04:00
8c3e0eb1c1
Normalized spelling of "lowercase" and "lowercased".
2018-09-25 10:30:18 -04:00
ad9a28ee38
Refs #29784 -- Normalized Python docs links to omit the version.
2018-09-25 10:19:42 +02:00
Nick Pope
sage
Adam Johnson
Greg Kaleka
Hasan Ramezani
Simon Charette
Hannes Ljungberg
Philipp Bosch
Adam Radwon
Shrikrishna Singh
Carlton Gibson
Matheus Cunha Motta
Jon Dufresne
Mariusz Felisiak
Sergey Fedoseev
Caio Ariede
David Foster
René Fleschenberg
Simon Charette
Tobias Kunze
Shai Berger
Dan Swain
daniel a rios
Meysam
Akshesh
Przemysław Suliga
Daniel Musketa
Tim Graham
Collin Anderson
Matt Wiens
François Freitag
Katie McLaughlin
Peter Inglesby