Commit graph

606 commits

Author SHA1 Message Date
Johanan-Ayadata
5045dab4f9 [5.1.x] Added missing lang attributes to html elements in docs.
Backport of 97a6a678c4 from main.
2024-10-30 14:04:37 +01:00
Maria Hynes
0a1091f118 [5.1.x] Removed unneeded OS reference on running the test suite in contributing docs.
This is not needed as the console snippet has buttons that allows the user to choose their OS.

Backport of 163e72ebba from main.
2024-10-29 11:37:18 +01:00
Mariusz Felisiak
8d48fc035c [5.1.x] Updated tutorial part count from 7 to 8 in docs/intro/reusable-apps.txt.
Backport of f59cdd0009 from main.
2024-10-21 14:20:39 -03:00
Chiara Mezzavilla
b852989c30 [5.1.x] Explained exception to using include() within urlpatterns in tutorial 1.
Backport of 40a60d589e from main.
2024-10-09 11:47:09 -03:00
Meta
2bd546957d [5.1.x] Fixed #35502 -- Removed duplication of "mysite" directory name in intro docs.
Reorganized intro docs when explaining `django-admin startproject` to prevent
confusion when using "mysite" as both the top-level directory and the Django
project directory name.

Co-authored-by: Natalia <124304+nessita@users.noreply.github.com>
Co-authored-by: Sarah Boyce <42296566+sarahboyce@users.noreply.github.com>
Co-authored-by: Carlton Gibson <carlton@noumenal.es>

Backport of d2c74cfb48 from main.
2024-10-09 09:13:37 -03:00
Mariusz Felisiak
e2551b30ad [5.1.x] Refs #34900 -- Doc'd Python 3.13 compatibility.
Backport of 2e3bc59fd3 from main.
2024-10-09 09:56:42 +02:00
Chiara Mezzavilla
53031136f5 [5.1.x] Relocated path() explanation to docs/ref/urls.txt to simplify tutorial 1.
Co-authored-by: Natalia <124304+nessita@users.noreply.github.com>

Backport of 73e8e81141 from main.
2024-09-30 13:32:39 -03:00
Mariatta
9da696f539 [5.1.x] Fixed #35737 -- Clarified where "models" comes from in tutorial 7.
Backport of 01a4d8a3c7 from main.
2024-09-05 21:37:46 -03:00
Mariusz Felisiak
20bd3f02be [5.1.x] Used :pypi: role in docs where appropriate.
Backport of 304d256674 from main.
2024-08-05 10:36:41 -03:00
Natalia
e934dcfb85 [5.1.x] Refs #35380 -- Updated screenshots in intro docs.
Backport of fb6050e784 from main.
2024-08-05 09:11:28 -03:00
lucas-r-oliveira
defd307be8 [5.1.x] Fixed 35506 -- Clarified initial references to URLconf in tutorial 1.
Backport of 2c931fda5b from main.
2024-07-08 22:03:07 -03:00
Kudz
b38a181481 [5.1.x] Relocated database setup details to install docs to simplify tutorial 2.
Co-authored-by: Natalia <124304+nessita@users.noreply.github.com>

Backport of 82c71f0168 from main.
2024-07-04 15:32:05 -03:00
Carlton Gibson
3b5d04f879 [5.1.x] Removed unneeded hyphens in "counterintuitive".
Follow-up to 65ad4ade74 which added
counterintuitive to the wordlist. Removes unneeded (antiquated)
hyphenated usages.

See e.g. https://www.merriam-webster.com/dictionary/counterintuitive

Backport of 704192e478 from main.
2024-07-04 08:32:34 +02:00
Sarah Boyce
6a574d7f83 [5.1.x] Refs #35380 -- Updated screenshots in intro docs.
Backport of a6dde9fbd5 from main.
2024-06-25 17:46:15 -03:00
Sarah Boyce
c99ce49d2e [5.1.x] Fixed #35558 -- Increased inline H3 headers color prominence in admin change page.
Backport of e510bb1ab1 from main.
2024-06-25 14:04:07 -03:00
arjunomray
ddf81f023f [5.1.x] Fixed #35540 -- Fixed the padding on admin login page.
Backport of d9bd58c3b8 from main.
2024-06-25 11:42:00 +02:00
Rosana Rufer
9143ecfd8b [5.1.x] Fixed #35461 -- Updated misleading django-debug-toolbar instructions.
The DjDT "handle" isn't visible on the polls application as the templates
are missing <body> tags for brevity.

Backport of 72b7aecbbf from main.
2024-06-21 13:20:41 +02:00
Andreu Vallbona
ae032fed89 [5.1.x] Moved confirmation about dev server running to earlier in tutorial 1.
Backport of f812b927a5 from main.
2024-06-09 14:52:54 -03:00
Andreu Vallbona
bae675f4a4 [5.1.x] Replaced usage of "patch" with more precise terms in faq, howto, and intro docs.
Backport of 85240139ca from main.
2024-06-09 14:40:18 -03:00
Andreu Vallbona
d14e815568 [5.1.x] Simplified tutorial 1 when describing how to run the dev server.
Backport of 3556f63c4c from main.
2024-06-09 04:45:22 -03:00
Ismael
337297891f [5.1.x] Fixed #35503 -- Removed distracting PHP reference in tutorial 1.
Backport of 6efbeb997c from main.
2024-06-08 09:43:30 -03:00
Aleksander Milinkevich
c223d14025
Corrected description of list_display being a list in tutorial 7. 2024-04-11 18:00:17 -03:00
Lang Tran
e279c724c1
Fixed #35347 -- Clarified choice_set attribute in tutorial 2. 2024-04-04 16:05:18 -03:00
Taishi Endo
0df520979a
Restored django.db.models.F import in final code snippet added at the beginning of tutorial 4. 2024-03-29 12:33:08 -03:00
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
Claude Paroz
f71bcc001b Changed packing recommendation to use pyproject.toml in reusable apps docs. 2024-02-01 11:01:57 +01:00
Mariusz Felisiak
305757aec1
Applied Black's 2024 stable style.
https://github.com/psf/black/releases/tag/24.1.0
2024-01-26 12:45:07 +01:00
Adam Johnson
a5622f84ab
Fixed tutorial 'background.gif' reference.
Missed in 76fda7729e.
2024-01-22 05:25:28 +01:00
Emmanuel Katchy
12ffcfc350 Updated "Dive Into Python" links. 2024-01-20 19:43:55 +01:00
Amir Karimi
27a3eee721 Fixed #31700 -- Made makemigrations command display meaningful symbols for each operation. 2024-01-17 14:00:02 +01:00
Adam Johnson
05f124348e Fixed #35084 -- Recommended 'django_' prefix for reusable app modules. 2024-01-04 09:54:37 +01:00
Adam Johnson
c65f49d3cb
Refs #33690 -- Updated tutorial for admin dark mode toggle. 2024-01-03 22:17:57 +01:00
Mohammad Yameen
bb560651c4
Corrected method/function wording in tutorial 3. 2023-12-29 06:01:18 +01:00
virgitl.io
acfdf39506
Added backticks around name argument in tutorial 3. 2023-12-29 05:57:30 +01:00
Nanami
5b52376d9f
Fixed HTML code snippet in Tutorial's part 7 when customizing the admin's site header. 2023-12-14 10:09:34 -03:00
Mariusz Felisiak
ecfea054ee Refs #34118 -- Doc'd Python 3.12 compatibility in Django 4.2.x. 2023-11-19 16:31:46 +01:00
Natalia
d21ab70223 Reorganized tutorial's part 4 to better understand changes needed in URLConf. 2023-10-10 10:49:27 -03:00
sarahboyce
e083f3082c Refs #34043 -- Clarified how to test UI changes. 2023-10-09 10:45:29 +02:00
Mariusz Felisiak
54b23b1835
Added backticks to setuptools in docs. 2023-10-09 09:55:52 +02:00
Cerebro Cerberus
6fbe5287ac
Fixed typo in docs/intro/tutorial08.txt. 2023-06-28 07:08:51 +02:00
Howard Cox
cd413bd78a Fixed #34621 -- Made admin site header render in <div> tag.
This was problematic for screen reader users because they use headings
to navigate. Having two <h1> is confusing, and the one in the header
wasn’t particularly helpful since it’s the same on all pages.
2023-06-05 11:55:06 +02:00
Mohit Singh Sinsniwal
89f10a80d7 Fixed #34579 -- Added Django Forum to contributing guides.
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2023-05-22 20:21:18 +02:00
Tim Graham
2c4dc64760 Used extlinks for PyPI links.
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2023-04-17 06:55:32 +02:00
sarahboyce
868e2fcdda Fixed #32539 -- Added toggleable facet filters to ModelAdmin.
Thanks Carlton Gibson, Simon Willison, David Smith, and Mariusz
Felisiak for reviews.
2023-03-03 20:24:57 +01:00
django-bot
14459f80ee Fixed #34140 -- Reformatted code blocks in docs with blacken-docs. 2023-03-01 13:03:56 +01:00
Joseph Victor Zammit
ba755ca131 Refs #34140 -- Corrected rst code-block and various formatting issues in docs. 2023-02-28 12:21:37 +01:00
Carlton Gibson
534ac48297 Refs #34140 -- Applied rst code-block to non-Python examples.
Thanks to J.V. Zammit, Paolo Melchiorre, and Mariusz Felisiak for
reviews.
2023-02-10 19:19:13 +01:00
Carlton Gibson
1df7814e4b
Refs #34146 -- Fixed typos in tutorial. (#16530)
- Fixed formatting on index page.
- Removed duplicate What's next section.

Thanks to Tim Graham for the report.
2023-02-07 20:19:58 +01:00
Tim Schilling
7715c9fef5
Fixed #34146 -- Added 3rd-party lib tutorial step.
Added a tutorial step that highlights Django Debug Toolbar, on of the
most common third party packages. It also added a mention of
djangopackages.com as a place to search for other libraries and a
link to Adam Johnson’s post on evaluating whether a package is
well-maintained.

Third-party packages are one of Django’s strengths. This should give
folks a sound route in.
2023-02-07 15:26:37 +01:00
Mariusz Felisiak
3bbe22dafc
Fixed #34233 -- Dropped support for Python 3.8 and 3.9. 2023-01-18 09:46:01 +01:00