Commit Graph

2837 Commits

Author SHA1 Message Date
Mariusz Felisiak ca769c8c13
Fixed #31505 -- Doc'd possible email addresses enumeration in PasswordResetView. 2020-04-27 18:06:11 +02:00
Tanmay Vijay e43abbbd70 Doc'd PasswordChangeView/PasswordResetView.success_url defaults. 2020-04-24 08:21:51 +02:00
Mads Jensen 060d9d4229
Added link to Mozilla's infosec page on web security. 2020-04-22 16:26:15 +02:00
Jon Dufresne 505fec6bad Capitalized Unicode in docs, strings, and comments. 2020-04-20 12:10:33 +02:00
Jon Dufresne fb21625270
Refs #30165 -- Removed obsolete doc references to deprecated ugettext() & co.
The u-prefixed variants were removed from the documentation in
6eb4996672.
2020-04-20 07:57:24 +02:00
Mariusz Felisiak f1a808a502 Used :rfc: role in various docs. 2020-04-15 18:31:30 +02:00
Claude Paroz 71c4fb7beb Refs #27468 -- Changed default Signer algorithm to SHA-256. 2020-04-15 12:49:14 +02:00
Andrew Godwin b5ad450fa6
Refs #31224 -- Removed incorrect @sync_to_async(thread_sensitive=True) example.
It does not support thread_sensitive when used as a decorator, yet.
2020-04-14 07:26:16 +02:00
miigotu 210657b791 Fixed #28184 -- Allowed using a callable for FileField and ImageField storage. 2020-04-08 11:26:17 +02:00
Mariusz Felisiak 678f958ef9 Fixed highlightlang deprecation warning on Sphinx 1.8+. 2020-04-07 09:48:52 +02:00
Mariusz Felisiak 69e2cd6fed Fixed Sphinx warnings on duplicate object descriptions. 2020-04-07 09:48:52 +02:00
Simon Charette fa5e7e46d8 Fixed #31423 -- Clarified nested atomic() example. 2020-04-04 20:39:33 +02:00
Adam Johnson 1cdfe8d912 Prevented (and corrected) single backtick usage in docs. 2020-04-01 14:55:11 +02:00
Hasan Ramezani 8aa71f4e87 Fixed #31375 -- Made contrib.auth.hashers.make_password() accept only bytes or strings. 2020-03-31 10:52:56 +02:00
Adam Johnson 4216225480
Clarified async documentation. 2020-03-26 16:46:24 +01:00
Adam Johnson f344c75fb0 Added additional note that tests use locmem email backend. 2020-03-25 15:01:39 +01:00
Adam Johnson b15b3706fe
Improved docs on migration reversibility. (#12619)
- Clarify reversibility for RunSQL and RunPython operations.
- Add example for migrate with irreversible migration.

Co-authored-by: Carlton Gibson <carlton.gibson@noumenal.es>
2020-03-25 14:37:54 +01:00
Adam Johnson 66b06822d0
Improved sessions notes in deployment checklist.
- Added note to clear old sessions when using database-backend.
- Made note to consider the cache backend more generic.
2020-03-25 12:04:52 +01:00
Hannes Ljungberg f3da09df0f Fixed #31396 -- Added binary XOR operator to F expressions. 2020-03-25 10:16:30 +01:00
Andrew Godwin fc0fa72ff4 Fixed #31224 -- Added support for asynchronous views and middleware.
This implements support for asynchronous views, asynchronous tests,
asynchronous middleware, and an asynchronous test client.
2020-03-18 19:59:12 +01:00
Carlton Gibson f622b49010 Fixed typo in docs/topics/async.txt. 2020-03-17 20:57:02 +01:00
Ben Li-Sauerwine fc84848cd9
Made logging config examples more accessible.
- Show an initial example configuring the root logger to output to the console.
- Then add more logging from the `django` named logger.
- Then show the file and more complex examples.

Adjusted surrounding text for reading flow.

Co-authored-by: Carlton Gibson <carlton.gibson@noumenal.es>
2020-03-17 11:51:05 +01:00
Philipp Bosch f75af5b67b Corrected outdated sentence in One-to-one relationships docs. 2020-03-17 10:49:37 +01:00
Andrew Godwin 40a64dd1e2 Refs #31224 -- Doc'd async adapter functions. 2020-03-13 07:13:44 +01:00
Claude Paroz e3e48b0012
Fixed #30439 -- Added support for different plural forms for a language.
Thanks to Michal Čihař for review.
2020-03-10 15:56:32 +01:00
Adam Radwon a2f554249e
Fixed #27865 -- Adjusted docs example to avoid confusion with models.BaseManager. 2020-03-10 09:14:30 +01:00
Shrikrishna Singh 370628673b
Fixed #31350 -- Fixed typo in docs/topics/db/optimization.txt. 2020-03-09 07:54:25 +01:00
Mariusz Felisiak 30ca66eadd
Added missing backticks in various docs. 2020-03-06 11:52:49 +01:00
Carlton Gibson 08a6215d33 Fixed #31342 -- Clarified docs about using base managers for related objects. 2020-03-06 11:08:08 +01:00
Claude Paroz 2f53d324de Fixed #31341 -- Doc'd minimal gettext version with ES6 template strings support. 2020-03-05 13:21:54 +01:00
Jon Dufresne 769cee5252 Fixed #31327 -- Deprecated providing_args argument for Signal. 2020-03-05 09:38:52 +01: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
Hasan Ramezani b7795d7673 Fixed #30040 -- Used default permission name in docs examples to avoid confusion. 2020-02-19 15:39:47 +01:00
Yoo In Keun 4ef107e34f Fixed typos in docs and a test comment. 2020-02-19 07:08:23 +01:00
Claude Paroz 4d973f5939 Refs #26601 -- Deprecated passing None as get_response arg to middleware classes.
This is the new contract since middleware refactoring in Django 1.10.

Co-authored-by: Carlton Gibson <carlton.gibson@noumenal.es>
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2020-02-18 20:03:44 +01:00
yura 54b7af7eb4 Fixed #31250 -- Ignored processing instructions in assertXMLEqual()/assertXMLNotEqual(). 2020-02-13 11:03:54 +01:00
Simon Charette 430e796980 Refs #31055 -- Made DiscoverRunner skip running system checks on unused test databases. 2020-02-07 11:01:31 +01:00
Claude Paroz 8c0c0235b6 Added tests for signing non-string values and updated docs. 2020-01-30 11:58:39 +01:00
Jon Dufresne 958977f662 Fixed #31212 -- Updated psycopg links to HTTPS and new location. 2020-01-29 06:25:40 +01:00
Claude Paroz 7fa0fa45c5 Refs #30997 -- Removed HttpRequest.is_ajax() usage. 2020-01-27 08:52:40 +01:00
Claude Paroz d66d72f956 Refs #30997 -- Added HttpRequest.accepts(). 2020-01-24 14:24:59 +01:00
Roy Smith cf493e5c81 Fixed #31184 -- Clarified URL matching behavior in URL dispatcher docs. 2020-01-24 12:21:04 +01:00
Flavio Curella d08d4f464a Fixed #30765 -- Made cache_page decorator take precedence over max-age Cache-Control directive. 2020-01-16 13:39:16 +01:00
Mariusz Felisiak d202846ced
Refs #29998 -- Corrected auto-created OneToOneField parent_link in MTI docs. 2020-01-15 15:07:07 +01:00
Kal Sze aa6c620249 More accurate terminology ("logger" instead of "logging handler") in logging documentation. 2020-01-09 15:27:34 +01:00
Jack Cushman eb629f4c02 Fixed #30995 -- Allowed converter.to_url() to raise ValueError to indicate no match. 2020-01-09 14:41:41 +01:00
Jack Cushman 196009c72c Clarified that ValueError raised by converter.to_python() means no match unless another URL pattern matches. 2020-01-08 10:55:06 +01:00
Mark Bailey 0f0abc20be Fixed #31103 -- Improved pagination topic documentation. 2020-01-07 09:57:38 +01:00
Adam Johnson 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
Jon Dufresne 5e00bd1f77 Removed unnecessary code-block directives in various docs. 2019-12-23 14:47:13 +01:00
Garry Polley 0b698eaea6 Added example of assertNumQueries() with "using" kwarg in testing topics docs. 2019-12-20 08:07:36 +01:00
Nick Pope d8b6a76bc7 Refs #28954 -- Remove remaining Jython documentation.
There is still no further progress on Jython 3 since support for Jython
was stripped in Django 2.0. The developers experimenting with Jython 3
have stated that they would need to start from scratch, so it doesn't
look as though it will materialize for years to come.

Python 2 and Django 1.11, the last version to support Python 2.7, will
both be end-of-life before Django 3.1 is released. We should no longer
instruct users to use an unsupported version of Django.
2019-12-19 16:42:12 +01:00
Mike Hansen d291c72bf2 Fixed #30585 -- Added {% translate %} and {% blocktranslate %} template tags. 2019-12-18 13:15:38 +01:00
Hasan Ramezani 70d95682b1 Corrected some typos in documentation. 2019-12-18 11:36:27 +01:00
Hasan Ramezani 9736137cdc Fixed #31069, Refs #26431 -- Doc'd RegexPattern behavior change in passing optional named groups in Django 3.0. 2019-12-12 14:24:10 +01:00
Jon Dufresne e703b93a65 Fixed #31080 -- Removed redundant type="text/javascript" attribute from <script> tags. 2019-12-11 09:49:54 +01:00
Mariusz Felisiak 82a88d2f48
Fixed #31061 -- Ignored positional args in django.urls.resolve() when all optional named parameters are missing.
Regression in 76b993a117.

Thanks Claude Paroz for the report and Carlton Gibson for reviews.
2019-12-06 09:32:51 +01:00
Felipe Lee a2e96f7969 Fixed #20456 -- Added example of directly testing CBVs in topics docs. 2019-12-04 16:36:42 +01:00
Claude Paroz d83b585e5c Removed leftover word in CBV mixins docs. 2019-12-04 08:59:44 +01:00
Andrew Godwin c90ab30fa1 Fixed #31056 -- Allowed disabling async-unsafe check with an environment variable. 2019-12-03 17:29:31 +01:00
Andrew Godwin 635a3f8e6e Refs #30451 -- Doc'd asynchronous support and async-safety. 2019-12-03 17:29:10 +01:00
Claude Paroz b92d101bd8 Fixed typo in topics docs 2019-12-03 16:49:57 +01:00
Sergey Fedoseev abc51d44af Used 🎫 role in all tickets links. 2019-11-26 14:02:24 +01:00
Mariusz Felisiak 3e5b349535
Fixed #31008 -- Fixed typos in docs/topics/logging.txt. 2019-11-20 20:35:36 +01:00
Caio Ariede 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
Caio Ariede 555bebe774 Fixed #30987 -- Added models.PositiveBigIntegerField. 2019-11-19 09:34:11 +01:00
Simon Charette 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
daniel a rios efc3e32d6d Fixed #30759 -- Made cache.delete() return whether it succeeded.
Thanks Simon Charette for the review.
2019-11-14 11:14:11 +01:00
David Foster 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
Mariusz Felisiak 08c0d8b16b Fixed typo in docs/topics/files.txt. 2019-11-11 11:51:39 +01:00
Jon Dufresne 85efc14a2e Fixed #30948 -- Changed packaging to use declarative config in setup.cfg.
Co-authored-by: Nick Pope <nick.pope@flightdataservices.com>
2019-11-08 14:14:13 +01:00
Shipeng Feng 8058d9d7ad Fixed #30955 -- Doc'd that only concrete base models are stored in historical models bases.
Abstract models are removed from bases when generating historical model
state since 6436f1fad9.
2019-11-08 09:41:36 +01:00
René Fleschenberg 367634f976 Replaced 'n_' prefix with 'number_of_' in docs/topics/db/queries.txt. 2019-11-07 09:22:13 +01:00
Jon Dufresne fbbff7f808 Refs #29983 -- Added pathlib.Path support to the file email backend. 2019-11-06 09:33:07 +01:00
Mariusz Felisiak 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
Adam Johnson 5a856669bf Updated list of field types conversions in ModelForm docs. 2019-11-04 10:31:48 +01:00
Mariusz Felisiak a370dbd954
Corrected error message in Many-to-many relationships docs. 2019-10-30 16:17:20 +01:00
Ken Whitesell 4c762588ff Fixed #30917 -- Clarified formsets topic documentation. 2019-10-30 08:41:31 +01:00
Hasan Ramezani f57e174fa6 Fixed #13750 -- Clarified need to reopen models.ImageField.image file to access raw image data. 2019-10-29 14:29:39 +01:00
Mariusz Felisiak bf7b3e2750 Fixed typo in docs/topics/files.txt. 2019-10-29 14:28:05 +01:00
Adam Johnson ab0fd3f58f Documented the order in which signal receivers are called. 2019-10-28 13:31:23 +01:00
Pavel Savchenko 1711c509fa Fixed #27391 -- Implemented SimpleTestCase.debug().
debug() should bubbled up exceptions if occurring in test, but behave
the same as run() when no exceptions occurred.
2019-10-18 12:22:51 +02:00
Simon Charette 35396a7f24 Refs #26207 -- Removed obsolete note about slow constructing a model with deferred fields.
This is not true since 7f51876 removed the necessity of creating
proxy model classes at runtime for each deferred field sets.
2019-10-14 12:51:07 +02:00
Flavio Curella ed112fadc1 Fixed #23755 -- Added support for multiple field names in the no-cache Cache-Control directive to patch_cache_control().
https://tools.ietf.org/html/rfc7234#section-5.2.2.2
2019-10-10 19:30:51 +02:00
Mac Chapman 0b7378db1f Fixed #11097 -- Added note about parent link fields in formsets for multi-table inheritance models. 2019-10-09 12:20:09 +02:00
Caio Ariede dafdfd6a60 Fixed #28790 -- Doc'd how to avoid running certain test classes in parallel. 2019-10-08 12:11:06 +02:00
David Vaz 45554fd5c5 Fixed #30597 -- Clarified how to unapply migrations. 2019-09-27 21:25:27 +02:00
Adam Johnson 566fca14b3
Documented admonition on when to use custom signals (#11814)
Thanks Cesar Canassa for the suggestion and Aymeric Augustin for review.
2019-09-25 10:28:08 +01:00
Mariusz Felisiak aad46ee274 Refs #27910 -- Doc'd support for enumeration types serialization in migrations. 2019-09-24 13:54:08 +02:00
Mariusz Felisiak bc46e386c7 Refs #30350 -- Doc'd support for range serialization in migrations. 2019-09-24 13:53:59 +02:00
Ryan Nowakowski 3f141719a1 Updated the default cache key transformation in documentation.
Follow up to 6c69de80bd.
2019-09-24 12:42:43 +02:00
Claude Paroz d71497bb24 Refs #26601 -- Used new-style middlewares in documentation. 2019-09-24 09:58:17 +02:00
Mariusz Felisiak 0ddb4ebf7b Refs #14357 -- Made Meta.ordering not affect GROUP BY queries.
Per deprecation timeline.
2019-09-10 12:01:00 +02:00
Mariusz Felisiak b61ea56789 Refs #28478 -- Removed support for TestCase's allow_database_queries and multi_db per deprecation timeline. 2019-09-10 12:01:00 +02:00
Mariusz Felisiak 416c584cab Removed versionadded/changed annotations for 2.2. 2019-09-10 12:01:00 +02:00
Nick Pope 406dba04e1 Fixed #29406 -- Added support for Referrer-Policy header.
Thanks to James Bennett for the initial implementation.
2019-09-09 13:35:41 +02: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
Nasir Hussain 25706d7285 Fixed #29714 -- Allowed using ExceptionReporter subclass with AdminEmailHandler. 2019-09-04 08:40:46 +02:00
Berker Peksag 400ec5125e Fixed #18763 -- Added ModelBackend/UserManager.with_perm() methods.
Co-authored-by: Nick Pope <nick.pope@flightdataservices.com>
2019-08-29 19:32:12 +02:00