Skip to content

Add resources section to the documentation #2081

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Feb 25, 2025
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/changes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ Pending

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

5.0.1 (2025-01-13)
------------------
Expand Down
1 change: 1 addition & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ Django Debug Toolbar
tips
panels
commands
resources
changes
contributing
architecture
81 changes: 81 additions & 0 deletions docs/resources.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
Resources
=========

Tutorials
---------

Django Debugging Tutorial
^^^^^^^^^^^^^^^^^^^^^^^^^

Originally presented as an in-person workshop at DjangoCon US 2022, this
tutorial by **Tim Schilling** covers debugging techniques in Django. Follow
along independently using the slides and GitHub repository.

* `Read the blog post <https://www.better-simple.com/django/2022/11/18/django-debugging-tutorial/>`__
* `Follow along with the GitHub repo <https://github.com/tim-schilling/debug-tutorial/>`__
* Last updated: February 13, 2025.
* Estimated time to complete: 1-2 hours.

Mastering Django Debug Toolbar: Efficient Debugging and Optimization Techniques
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

This tutorial by **Bob Berderbos** provides an in-depth look at effectively
using Django Debug Toolbar to debug Django applications, covering installation,
configuration, and practical usage.

* `Watch on YouTube <https://www.youtube.com/watch?v=c5riXBYFxLk>`__
* Published: May 13, 2023.
* Duration: 11 minutes.

Talks
-----

A Related Matter: Optimizing Your Web App by Using Django Debug Toolbar
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Presented at DjangoCon US 2024 by **Christopher Adams**, this talk delves into
optimizing web applications using Django Debug Toolbar, focusing on SQL query
analysis and performance improvements.

* `Watch on DjangoTV <https://djangotv.com/videos/djangocon-us/2024/a-related-matter-optimizing-your-webapp-by-using-django-debug-toolbar-with-christopher-adams/>`__
* `Watch on YouTube <https://www.youtube.com/watch?v=iKn5VWD9l6E>`__
* Published: December 6, 2024.
* Duration: 26 minutes.

Fast on My Machine: How to Debug Slow Requests in Production
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Presented at DjangoCon Europe 2024 by **Raphael Michel**, this talk explores
debugging slow requests in production. While not focused on Django Debug
Toolbar, it highlights performance issues the tool can help diagnose.

* `Watch on DjangoTV <https://djangotv.com/videos/djangocon-europe/2024/djangocon-europe-2024-fast-on-my-machine-how-to-debug-slow-requests-in-production/>`__
* `Watch on YouTube <https://www.youtube.com/watch?v=sPO6wDlvKVI>`__
* Published: July 11, 2024.
* Duration: 23 minutes.

Criteria for Inclusion
----------------------

The following criteria ensure that included resources are relevant,
informative, and valuable to users:

1. Relevance to Django Debug Toolbar
2. Originality and expertise
3. Recency and accuracy
4. Production quality
5. Practicality and depth
6. Language and accessibility

Contributing
------------

If you have a video talk or tutorial that you believe should be included in
this list, please consider contributing.

See the :doc:`contributing documentation <contributing>` for details.

We are looking for resources that provide insights into using Django Debug
Toolbar for use cases beyond the basic setup and configuration. Talks and
tutorials that cover advanced debugging techniques, performance optimization,
and real-world applications are particularly welcome.
Loading