0
0
mirror of https://github.com/django/django.git synced 2024-11-25 07:59:34 +01:00
django/docs
Carlton Gibson 0a646c8e08 Removed distracting note from tutorial 4.
The note on a possible race condition is inappropriate in this
tutorial setting. To quote Diátaxis:

> Your job is to guide the learner to a successful conclusion. There
> may be many interesting diversions along the way … - ignore them.

Co-Authored-By: Ryan Hiebert <ryan@ryanhiebert.com>
2024-02-21 06:21:20 +01:00
..
_ext Applied Black's 2024 stable style. 2024-01-26 12:45:07 +01:00
_theme
faq
howto Corrected BaseCommand.check() signature in docs. 2024-01-30 11:10:38 +01:00
internals Fixed typo in docs/internals/contributing/writing-code/coding-style.txt. 2024-02-08 05:57:59 +01:00
intro Removed distracting note from tutorial 4. 2024-02-21 06:21:20 +01:00
man
misc Removed mention of designers in DTL design philosophy. 2024-02-01 09:20:11 +01:00
ref Fixed #35153 -- Added note about locale name notation to FORMAT_MODULE_PATH docs. 2024-02-20 05:29:15 +01:00
releases Fixed #35238 -- Fixed database serialization crash when base managers use prefetch_related(). 2024-02-20 22:14:17 +01:00
topics Fixed #34429 -- Allowed setting unusable passwords for users in the auth forms. 2024-02-20 12:13:32 -03:00
conf.py
contents.txt
glossary.txt
index.txt
make.bat
Makefile
README.rst
requirements.txt
spelling_wordlist Fixed #24018 -- Allowed setting pragma options on SQLite. 2024-02-16 12:59:19 +01:00

The documentation in this tree is in plain text files and can be viewed using
any text file viewer.

It uses `ReST`_ (reStructuredText), and the `Sphinx`_ documentation system.
This allows it to be built into other forms for easier viewing and browsing.

To create an HTML version of the docs:

* Install Sphinx (using ``python -m pip install Sphinx`` or some other method).

* In this docs/ directory, type ``make html`` (or ``make.bat html`` on
  Windows) at a shell prompt.

The documentation in ``_build/html/index.html`` can then be viewed in a web
browser.

.. _ReST: https://docutils.sourceforge.io/rst.html
.. _Sphinx: https://www.sphinx-doc.org/