Skip to content

Commit 8230a33

Browse files
Add resources section to the documentation
This commit adds a new section to the documentation, "Resources", which provides a curated list of tutorials and talks. Issue #2070
1 parent 19bb9aa commit 8230a33

File tree

3 files changed

+83
-0
lines changed

3 files changed

+83
-0
lines changed

docs/changes.rst

+1
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ Pending
66

77
* Added Django 5.2 to the tox matrix.
88
* Updated package metadata to include well-known labels.
9+
* Added resources section to the documentation.
910

1011
5.0.1 (2025-01-13)
1112
------------------

docs/index.rst

+1
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ Django Debug Toolbar
1010
tips
1111
panels
1212
commands
13+
resources
1314
changes
1415
contributing
1516
architecture

docs/resources.rst

+81
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
Resources
2+
=========
3+
4+
Tutorials
5+
---------
6+
7+
Django Debugging Tutorial
8+
^^^^^^^^^^^^^^^^^^^^^^^^^
9+
10+
Originally presented as an in-person workshop at DjangoCon US 2022, this
11+
tutorial by **Tim Schilling** covers debugging techniques in Django. Follow
12+
along independently using the slides and GitHub repository.
13+
14+
* `Read the blog post <https://www.better-simple.com/django/2022/11/18/django-debugging-tutorial/>`__
15+
* `Follow along with the GitHub repo <https://github.com/tim-schilling/debug-tutorial/>`__
16+
* Last updated: February 13, 2025.
17+
* Estimated time to complete: 1-2 hours.
18+
19+
Mastering Django Debug Toolbar: Efficient Debugging and Optimization Techniques
20+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
21+
22+
This tutorial by **Bob Berderbos** provides an in-depth look at effectively
23+
using Django Debug Toolbar to debug Django applications, covering installation,
24+
configuration, and practical usage.
25+
26+
* `Watch on YouTube <https://www.youtube.com/watch?v=c5riXBYFxLk>`__
27+
* Published: May 13, 2023.
28+
* Duration: 11 minutes.
29+
30+
Talks
31+
-----
32+
33+
A Related Matter: Optimizing Your Webapp by Using Django Debug Toolbar
34+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
35+
36+
Presented at DjangoCon US 2024 by **Christopher Adams**, this talk delves into
37+
optimizing web applications using Django Debug Toolbar, focusing on SQL query
38+
analysis and performance improvements.
39+
40+
* `Watch on DjangoTV <https://djangotv.com/videos/djangocon-us/2024/a-related-matter-optimizing-your-webapp-by-using-django-debug-toolbar-with-christopher-adams/>`__
41+
* `Watch on YouTube <https://www.youtube.com/watch?v=iKn5VWD9l6E>`__
42+
* Published: December 6, 2024.
43+
* Duration: 26 minutes.
44+
45+
Fast on My Machine: How to Debug Slow Requests in Production
46+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
47+
48+
Presented at DjangoCon Europe 2024 by **Raphael Michel**, this talk explores
49+
debugging slow requests in production. While not focused on Django Debug
50+
Toolbar, it highlights performance issues the tool can help diagnose.
51+
52+
* `Watch on DjangoTV <https://djangotv.com/videos/djangocon-europe/2024/djangocon-europe-2024-fast-on-my-machine-how-to-debug-slow-requests-in-production/>`__
53+
* `Watch on YouTube <https://www.youtube.com/watch?v=sPO6wDlvKVI>`__
54+
* Published: July 11, 2024.
55+
* Duration: 23 minutes.
56+
57+
Criteria for Inclusion
58+
----------------------
59+
60+
The following criteria ensure that included resources are relevant, informative,
61+
and valuable to users:
62+
63+
1. Relevance to Django Debug Toolbar
64+
2. Originality and expertise
65+
3. Recency and accuracy
66+
4. Production quality
67+
5. Practicality and depth
68+
6. Language and accessibility
69+
70+
Contributing
71+
------------
72+
73+
If you have a video talk or tutorial that you believe should be included in this
74+
list, please consider contributing.
75+
76+
See the :doc:`contributing documentation <contributing>` for details.
77+
78+
We are looking for resources that provide insights into using Django Debug Toolbar
79+
for use cases beyond the basic setup and configuration. Talks and tutorials that
80+
cover advanced debugging techniques, performance optimization, and real-world
81+
applications are particularly welcome.

0 commit comments

Comments
 (0)