Commit graph

621 commits

Author SHA1 Message Date
Ramiro Morales
7808a04fe5 [3.0.x] Corrected custom model fields how-to.
get_prep_value() method is complementary of from_db_value().

Follow up to e9103402c0.

Backport of 52a0a03671 from master
2020-07-10 11:38:26 +02:00
David Smith
8ec607be84 [3.0.x] Updated How to install Django on Windows guide.
Backport of 25352dc019 from master
2020-06-03 16:29:30 +02:00
Jon Dufresne
caf7c4630d [3.0.x] Fixed #31643 -- Changed virtualenv doc references to Python 3 venv.
Backport of 9f4ceee90a from master
2020-06-02 11:55:57 +02:00
Jon Dufresne
9f30a7ebd3 [3.0.x] Changed some doc links to use intersphinx.
Backport of 494ba27b5f from master
2020-05-29 21:11:42 +02:00
David Smith
066076afaa [3.0.x] Fixed #31628 -- Updated Windows install guide to recommend venv.
Backport of 922ff51f5a from master
2020-05-27 11:20:52 +02:00
Claude Paroz
7f1d73e1cf [3.0.x] Removed instructions for unsupported Apache versions.
Backport of cfa0c0e252 from master
2020-05-25 08:58:00 +02:00
Adam Johnson
0342d47e7a [3.0.x] Prevented (and corrected) single backtick usage in docs.
Backport of 1cdfe8d912 from master.
2020-04-01 15:15:21 +02:00
Adam Johnson
76db34e52a [3.0.x] 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.
Backport of 66b06822d0 from master
2020-03-25 12:05:36 +01:00
Adam Johnson
6b41f07720 [3.0.x] Clarified SeparateDatabaseAndState docs and added example of changing ManyToManyField.
Co-Authored-By: Mariusz Felisiak <felisiak.mariusz@gmail.com>
Co-Authored-By: Carlton Gibson <carlton.gibson@noumenal.es>
Co-Authored-By: René Fleschenberg <rene@fleschenberg.net>

Backport of a9ee6872bd from master
2020-03-10 11:14:05 +01:00
Mariusz Felisiak
f389e2c960 [3.0.x] Added missing backticks in various docs.
Backport of 30ca66eadd from master
2020-03-06 11:53:35 +01:00
Abhijeet
7d48a4b703 [3.0.x] Fixed #31126 -- Doc'd STATICFILES_DIRS namespacing in static files how-to.
Backport of a45c8d7ad0 from master
2020-01-29 10:36:52 +01:00
Adam Johnson
a062d432a3 [3.0.x] Made examples concrete in upgrade documentation.
Backport of e4bc4f26b2 from master
2020-01-21 13:03:00 +01:00
Takayuki Hirayama
f0e1a69c99 [3.0.x] Fixed #31171 -- Fixed wording in auto-escaping section of custom template tags docs.
Backport of 73563183c2 from master
2020-01-17 09:22:37 +01:00
Katie McLaughlin
407eeff9de [3.0.x] Refs #30767 -- Improved deployment documentation.
Backport of abeb4599af from master
2019-12-20 11:34:00 +01:00
Nick Pope
08b426aedb [3.0.x] 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.

Backport of d8b6a76bc7 from master
2019-12-19 16:44:39 +01:00
Adam Johnson
a334ae5d1e [3.0.x] Updated Pytest example in upgrade documentation.
Pytest changed their recommended entrypoint to 'pytest' in version 3.0.0 in 2016 : https://docs.pytest.org/en/latest/changelog.html#id1009. Also link the name since this is the only reference in the Django documentation at current.
Backport of ef3baf966d from master
2019-12-18 10:43:36 +01:00
Hasan Ramezani
895c0889e4 [3.0.x] Fixed #30999 -- Fixed typo in docs/howto/custom-template-tags.txt.
Backport of 33eecfa740 from master
2019-11-19 10:09:27 +01:00
Hasan Ramezani
6df42e6187 [3.0.x] Fixed #30906 -- Fixed an example of using the template system to generate CSV.
Backport of 05c3ef26a2 from master
2019-10-25 08:12:15 +02:00
Carlton Gibson
71489a522a [3.0.x] Fixed #30858 -- Clarified that AdminEmailHandler processes all 5xx responses.
Backport of 94eae4e563 from master
2019-10-09 10:16:03 +02:00
Katie McLaughlin
fee75d2aed Fixed #30767 -- Improved references to deployment documentation.
* Increased tocdepth to expose more complexity of topics.
* Ensured deployment checklist is linked on main doc page.
2019-09-09 10:02:33 +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
Mariusz Felisiak
6201141b2c Refs #30736 -- Added missing versionadded annotations for Storage.get_alternative_name().
Thanks Simon Charette for the report.
2019-08-31 07:19:19 +02:00
yukihira1992
0545781764 Fixed #30736 -- Added Storage.get_alternative_name() to allow customization. 2019-08-30 11:32:19 +02:00
Claude Paroz
7203efb799 Fixed #30694 -- Documented FileResponse does not seek its file source. 2019-08-17 09:20:36 +02:00
Frank Wiles
fa65b90a96 Updated WSGI servers ordering according to the more commonly used. 2019-07-16 14:43:59 +02:00
Andrew Godwin
a415ce70be Fixed #30451 -- Added ASGI handler and coroutine-safety.
This adds an ASGI handler, asgi.py file for the default project layout,
a few async utilities and adds async-safety to many parts of Django.
2019-06-20 12:29:43 +02:00
Hasan Ramezani
a7038adbd0 Fixed typos in signals and custom management commands docs. 2019-06-19 08:40:46 +02:00
Alex Gaynor
f011d9ea56 Fixed datetime string format examples in docs/howto/custom-template-tags.txt. 2019-05-22 06:47:32 +02:00
mentix02
fa422dd78b Changed poll_id to poll_ids in examples of custom management commands. 2019-05-20 10:11:38 +02:00
Jon Dufresne
e86cc14bd3 Changed docs to link to Python's description of iterable. 2019-05-17 17:27:19 +02:00
Daniel Musketa
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
Ramiro Morales
25b5eea8cd Fixed #30387 -- Enhanced docs CLI examples in Unit tests and Install Django on Windows.
Follow up to 37c17846ad.
2019-04-23 09:32:55 +02:00
Ramiro Morales
aed89adad5 Fixed #30367 -- Changed "pip install" to "python -m pip install" in docs, comments and hints. 2019-04-18 14:41:15 +02:00
Nick Pope
198a2a9381 Removed unnecessary /static from links to PostgreSQL docs. 2019-03-29 21:49:44 -04:00
David Beitey
9fd90c4088 Clarified deconstruct() in Custom Model Field docs. 2019-03-12 10:12:33 -04:00
Mariusz Felisiak
25829197bb
Removed extra characters in docs header underlines. 2019-02-08 21:38:30 +01:00
Himanshu Lakhara
22aab8662f Fixed #30004 -- Changed default FILE_UPLOAD_PERMISSION to 0o644. 2019-02-08 14:53:15 -05:00
Tim Graham
77d25dbd0f Refs #27753 -- Favored SafeString over SafeText. 2019-02-06 14:12:06 -05:00
Tim Graham
7e6b214ed3 Fixed #30116 -- Dropped support for Python 3.5. 2019-01-30 10:19:48 -05:00
Tim Graham
ec7e179aeb Removed versionadded/changed annotations for 2.1. 2019-01-17 10:50:25 -05:00
CHI Cheng
b7dbd5ff68 Fixed broken links to PyYAML page. 2018-12-27 10:48:37 +01:00
Rodrigo
ad191d9e01 Fixed #29895 -- Doc'd why MySQL's atomic DDL statements don't work for atomic migrations. 2018-12-06 16:03:02 -05:00
François Freitag
9b15ff08ba Used auto-numbered lists in documentation. 2018-11-15 13:54:28 -05:00
Mads Jensen
961f8e9985 Updated some links to https and new locations. 2018-11-10 17:40:50 -05:00
Adam Johnson
cecd656184 Simplified deployment checklist docs on customizing error views. 2018-10-11 09:50:08 -04:00
Jon Dufresne
82f286cf6f Refs #29784 -- Switched to https:// links where available. 2018-09-26 08:48:47 +02:00
Stephen Finucane
25f4302349 Emphasized that TemplatesSetting must be used to override widget templates. 2018-09-11 15:14:53 -04:00
Curtis Maloney
c49ea6f591 Refs #20910 -- Replaced snippet directive with code-block. 2018-09-10 13:00:34 -04:00
priyanshsaxena
83b04d4f88 Fixed #29048 -- Added **extra_context to database function as_vendor() methods. 2018-08-23 11:52:09 -04:00
Carlton Gibson
ef70af77ec Refs #28540 -- Added FILE_UPLOAD_PERMISSIONS to deployment checklist. 2018-08-04 10:39:22 -04:00