Skip to content

Commit e5c9561

Browse files
Add resources section to the documentation (#2081)
This adds a new section to the documentation, "Resources", which provides a curated list of tutorials and talks. - Favor conference site links and DjangoTV over YouTube - Make the invitation to contribute more inviting - Remove the criteria for inclusion and contributing sections
1 parent 8cb9638 commit e5c9561

File tree

3 files changed

+80
-0
lines changed

3 files changed

+80
-0
lines changed

Diff for: 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
------------------

Diff for: 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

Diff for: docs/resources.rst

+78
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
Resources
2+
=========
3+
4+
This section includes resources that can be used to learn more about
5+
the Django Debug Toolbar.
6+
7+
Tutorials
8+
---------
9+
10+
Django Debugging Tutorial
11+
^^^^^^^^^^^^^^^^^^^^^^^^^
12+
13+
Originally presented as an in-person workshop at DjangoCon US 2022, this
14+
tutorial by **Tim Schilling** covers debugging techniques in Django. Follow
15+
along independently using the slides and GitHub repository.
16+
17+
* `View the tutorial details on the conference website <https://2022.djangocon.us/tutorials/it-doesnt-work-a-djangonauts-debugging/>`__
18+
* `Follow along with the GitHub repository <https://github.com/tim-schilling/debug-tutorial/>`__
19+
* `View the slides on Google Docs <https://docs.google.com/presentation/d/1dmeFD5kGsukQaMinU0BJQyyCeu5ZGR4drc0pJilT10Y/edit?usp=share_link>`__
20+
* Last updated: February 13, 2025.
21+
* Estimated time to complete: 1-2 hours.
22+
23+
Mastering Django Debug Toolbar: Efficient Debugging and Optimization Techniques
24+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
25+
26+
This tutorial by **Bob Berderbos** provides an in-depth look at effectively
27+
using Django Debug Toolbar to debug Django applications, covering installation,
28+
configuration, and practical usage.
29+
30+
* `Watch on YouTube <https://www.youtube.com/watch?v=c5riXBYFxLk>`__
31+
* Published: May 13, 2023.
32+
* Duration: 11 minutes.
33+
34+
Talks
35+
-----
36+
37+
A Related Matter: Optimizing Your Web App by Using Django Debug Toolbar
38+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
39+
40+
Presented at DjangoCon US 2024 by **Christopher Adams**, this talk delves into
41+
optimizing web applications using Django Debug Toolbar, focusing on SQL query
42+
analysis and performance improvements.
43+
44+
* `View the talk details on the conference website <https://2024.djangocon.us/talks/a-related-matter-optimizing-your-webapp-by-using-django-debug-toolbar-select-related-and-prefetch-related/>`__
45+
* `Watch on DjangoTV <https://djangotv.com/videos/djangocon-us/2024/a-related-matter-optimizing-your-webapp-by-using-django-debug-toolbar-with-christopher-adams/>`__
46+
* Published: December 6, 2024.
47+
* Duration: 26 minutes.
48+
49+
Fast on My Machine: How to Debug Slow Requests in Production
50+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
51+
52+
Presented at DjangoCon Europe 2024 by **Raphael Michel**, this talk explores
53+
debugging slow requests in production. While not focused on Django Debug
54+
Toolbar, it highlights performance issues the tool can help diagnose.
55+
56+
* `View the talk details on the conference website <https://pretalx.evolutio.pt/djangocon-europe-2024/talk/QGLCYX/>`__
57+
* `Watch on DjangoTV <https://djangotv.com/videos/djangocon-europe/2024/djangocon-europe-2024-fast-on-my-machine-how-to-debug-slow-requests-in-production/>`__
58+
* Published: July 11, 2024.
59+
* Duration: 23 minutes.
60+
61+
Want to Add Your Content Here?
62+
------------------------------
63+
64+
Have a great tutorial or talk about Django Debug Toolbar? We'd love to
65+
showcase it! If your content helps developers improve their debugging skills,
66+
follow our :doc:`contributing guidelines <contributing>` to submit it.
67+
68+
To ensure relevant and accessible content, please check the following
69+
before submitting:
70+
71+
1. Does it at least partially focus on the Django Debug Toolbar?
72+
2. Does the content show a version of Django that is currently supported?
73+
3. What language is the tutorial in and what languages are the captions
74+
available in?
75+
76+
Talks and tutorials that cover advanced debugging techniques,
77+
performance optimization, and real-world applications are particularly
78+
welcome.

0 commit comments

Comments
 (0)