Commit Graph

684 Commits

Author SHA1 Message Date
Jon Dufresne 494ba27b5f
Changed some doc links to use intersphinx. 2020-05-29 21:09:57 +02:00
David Smith 922ff51f5a Fixed #31628 -- Updated Windows install guide to recommend venv. 2020-05-27 11:18:23 +02:00
Claude Paroz cfa0c0e252
Removed instructions for unsupported Apache versions. 2020-05-25 08:56:50 +02:00
Hasan Ramezani c60524c658 Fixed #31546 -- Allowed specifying list of tags in Command.requires_system_checks. 2020-05-21 12:34:54 +02:00
Nick Pope fbdb032de2 Used :envvar: role and .. envvar:: directive in various docs. 2020-05-13 09:14:40 +02:00
Nick Pope a9337b4add Used :pep: role in various docs. 2020-05-13 09:14:04 +02:00
Mariusz Felisiak 4c5236ef93 Removed versionadded/changed annotations for 3.0. 2020-05-13 09:07:51 +02:00
Adam Johnson d17b380653 Refs #30573 -- Rephrased "Of Course" and "Obvious(ly)" in documentation and comments. 2020-05-04 12:10:47 +02:00
David Smith bb13711451 Fixed #25712 -- Reorganized templates docs. 2020-04-30 08:12:09 +02:00
Adam Johnson 8e8c3f964e Refs #29501 -- Allowed customizing exit status for management commands. 2020-04-14 13:22:47 +02:00
Adam Johnson 1cdfe8d912 Prevented (and corrected) single backtick usage in docs. 2020-04-01 14:55:11 +02: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
Mariusz Felisiak 2117b7c12e
Updated settings example in overriding templates docs.
Follow up to ba4389a36b.
2020-03-21 20:02:57 +01:00
Adam Johnson a9ee6872bd 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>
2020-03-10 11:07:36 +01:00
Mariusz Felisiak 30ca66eadd
Added missing backticks in various docs. 2020-03-06 11:52:49 +01:00
Nick Pope 335c9c94ac Simplified imports from django.db and django.contrib.gis.db. 2020-02-04 13:20:06 +01:00
Abhijeet a45c8d7ad0
Fixed #31126 -- Doc'd STATICFILES_DIRS namespacing in static files how-to. 2020-01-29 10:34:34 +01:00
Adam Johnson e4bc4f26b2 Made examples concrete in upgrade documentation. 2020-01-21 13:02:14 +01:00
Takayuki Hirayama 73563183c2 Fixed #31171 -- Fixed wording in auto-escaping section of custom template tags docs. 2020-01-17 09:20:44 +01:00
Pavel Lysak 13e4abf83e Fixed #30752 -- Allowed using ExceptionReporter subclasses in error reports. 2020-01-16 15:25:49 +01:00
Carlton Gibson e2d9d66a22 Fixed #23004 -- Added request.META filtering to SafeExceptionReporterFilter.
Co-authored-by: Ryan Castner <castner.rr@gmail.com>
2020-01-10 11:35:41 +01:00
Carlton Gibson 581ba5a948 Refs #23004 -- Allowed exception reporter filters to customize settings filtering.
Thanks to Tim Graham for the original implementation idea.

Co-authored-by: Daniel Maxson <dmaxson@ccpgames.com>
2020-01-10 11:21:23 +01:00
Katie McLaughlin abeb4599af Refs #30767 -- Improved deployment documentation. 2019-12-20 10:42:56 +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
Adam Johnson ef3baf966d 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.
2019-12-18 10:42:41 +01:00
Fredrik 98188cb33d Refs #20935 -- Removed duplicate ToC references.
These sections are being referred to already from other locations. Having multiple references to the same location from the ToC is ambiguous, and causes errors in the EPUB build.
2019-12-04 11:36:40 +01:00
Hasan Ramezani 33eecfa740 Fixed #30999 -- Fixed typo in docs/howto/custom-template-tags.txt. 2019-11-19 10:08:32 +01:00
Jon Dufresne 26554cf5d1 Fixed #29983 -- Replaced os.path() with pathlib.Path in project template and docs.
Thanks Curtis Maloney for the original patch.
2019-11-07 11:11:27 +01:00
Hasan Ramezani 05c3ef26a2 Fixed #30906 -- Fixed an example of using the template system to generate CSV. 2019-10-25 08:11:11 +02:00
Carlton Gibson 94eae4e563 Fixed #30858 -- Clarified that AdminEmailHandler processes all 5xx responses. 2019-10-09 10:13:11 +02:00
Min ho Kim 103a6f4307 Fixed some typos in comments and docs.
Thanks to Mads Jenson for review.
2019-10-02 15:50:46 +02:00
Mariusz Felisiak 416c584cab Removed versionadded/changed annotations for 2.2. 2019-09-10 12:01:00 +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
Claude Paroz eac9ab7ebb Removed parser.add_arguments() arguments that match the defaults. 2018-07-02 17:54:57 -04:00
humbertotm e95008f241 Fixed #29152 -- Allowed passing kwargs to ArgumentParser initialization in management commands. 2018-06-16 15:54:59 -04:00
Dr. Shubham Dipt 44441d673b Corrected typo in outputting-csv.txt. 2018-06-01 12:07:55 +02:00
Srinivas Reddy Thatiparthy 4c35a173e8 Fixed #29423 -- Documented Field.value_from_object(). 2018-05-25 15:10:45 -04:00
Claude Paroz a177f854c3
Fixed #16470 -- Allowed FileResponse to auto-set some Content headers.
Thanks Simon Charette, Jon Dufresne, and Tim Graham for the reviews.
2018-05-15 18:12:11 +02:00
Claude Paroz d65b0f72de Fixed #17379 -- Removed management commands deactivation of the locale. 2018-05-13 10:21:53 +02:00
Mariusz Felisiak 35319bf12c
Alphabetized imports in various docs.
Follow-up of d97cce3409 and 7d3fe36c62.
2018-05-12 19:37:42 +02:00
Srinivas Reddy Thatiparthy d0b04c6308 Fixed #29360 -- Removed Fabric examples in docs. 2018-04-29 22:12:40 -04:00
Brett Cannon 64b74804c5 Fixed #29334 -- Updated pypi.python.org URLs to pypi.org. 2018-04-17 20:24:27 -04:00
Daniel Chimeno fbb9358149 Replaced 'python -Wall' with 'python -Wa'. 2018-03-28 13:25:03 -04:00
Tim Graham ba5f24ea64 Fixed #29265 -- Removed the suggestion to hardcode static URLs. 2018-03-28 11:16:01 -04:00
Tim Graham fd9398816e
Fixed #29165 -- Clarified how to load initial data with migrations. 2018-03-08 10:58:19 -05:00
Srinivas Reddy Thatiparthy (శ్రీనివాస్ రెడ్డి తాటిపర్తి) c4fa0143f7 Removed "Remove any old versions of Django" install instructions.
They are obsolete given the prevalence of pip.
2018-02-26 08:58:56 -05:00
Matthew Wilkes 2162f0983d Fixed #24747 -- Allowed transforms in QuerySet.order_by() and distinct(*fields). 2018-02-10 19:08:55 -05:00
Tim Graham 4775dcb521 Renamed the "Supported versions" label. 2018-01-31 10:17:06 -05:00
Jon Dufresne ff05de760c Fixed #29038 -- Removed closing slash from HTML void tags. 2018-01-21 02:09:10 -05:00
Ramiro Morales 37c17846ad Fixed #28343 -- Add an OS chooser for docs command line examples. 2018-01-20 12:38:48 -05:00
Tim Graham b9cec9fa1f Fixed #29017 -- Updated BaseCommand.leave_locale_alone doc per refs #24073. 2018-01-12 14:18:32 -05:00
Mariusz Felisiak 7c81b28ebc
Updated various links in docs to use HTTPS. 2018-01-07 14:28:41 +01:00
я котик пур-пур ccc25bfe4f Refs #23919 -- Removed obsolete __init__.py files in management command directories. 2018-01-03 11:02:26 -05:00
Claude Paroz 23b21db31b Fixed #28594 -- Removed Jython docs and specific code
Thanks Andrey Martyanov for the reporti, and Tim Graham for the review.
2017-12-23 10:26:32 +01:00
Ville Skyttä 617686e226 Fixed 'a'/'an' mix-ups in docs. 2017-10-30 21:47:09 -04:00
jkrzy 48d92fea67 Fixed #28367 -- Doc'd how to override management commands. 2017-09-02 16:21:13 -04:00
Berker Peksag c362228556 Replaced "not A== B" with "A != B" in docs/howto/writing-migrations.txt. 2017-07-26 09:34:10 -04:00
Emmanuel 27ef04bb5c Fixed #28349 -- Doc'd how to upgrade Django from LTS to LTS. 2017-07-24 13:33:30 -04:00
Tim Graham 487362fa8f Fixed #28370 -- Deprecated the context arg of Field.from_db_value() and Expression.convert_value().
Unused since a0d166306f.
2017-07-20 16:30:08 -04:00
Mariusz Felisiak 081e787160 Refs #23919 -- Stopped inheriting from object to define new style classes.
Tests and docs complement to cecc079168.
2017-06-26 10:30:31 -04:00
Tim Graham 2503ad5154 Fixed #28327 -- Removed contradictory description of mod_wsgi docs. 2017-06-20 07:35:55 -04:00
Philip James 7c9a833301 Fixed #26028 -- Added overriding templates howto. 2017-06-02 18:17:27 -04:00
Claude Paroz 01f658644a Updated various links in docs to avoid redirects
Thanks Tim Graham and Mariusz Felisiak for review and completion.
2017-05-22 19:28:44 +02:00
Claude Paroz 301de774c2 Refs #27795 -- Replaced many force_text() with str()
Thanks Tim Graham for the review.
2017-04-27 09:10:02 +02:00
Richard Barrell 351835f262 Fixed #28031 -- Removed notes about old uWSGI/sentry versions (refs #20537). 2017-04-06 09:09:49 -04:00
Aleksej Manaev 7170820b4e Fixed typos in docs/howto/static-files/index.txt. 2017-04-03 08:13:48 -04:00
Jon Dufresne 7bbb5161ea Removed implicit default store_true/false argparse args.
argparse automatically sets the default value for store_true/false
arguments to its opposite.
2017-04-01 20:03:56 -04:00
Paolo Melchiorre 24d53786d4 Made a few cosmetic updates to "Migrations that add unique fields". 2017-03-27 14:07:11 -04:00
albertoconnor 2863e79a5c Fixed typo in docs/howto/custom-template-tags.txt. 2017-03-01 15:42:00 -05:00
Tim Graham 103e6cf26c Fixed #27823 -- Updated mod_wsgi example to use WSGIPythonHome. 2017-02-13 19:52:08 -05:00