Merge branch 'main' into show-toolbar-compat

docs/changes.rst

@@ -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.
 * Wrap ``SHOW_TOOLBAR_CALLBACK`` function with ``sync_to_async``
   or ``async_to_sync`` to allow sync/async compatibility.
 * Make ``require_toolbar`` decorator compatible to async views.

docs/index.rst

@@ -10,6 +10,7 @@ Django Debug Toolbar
    tips
    panels
    commands
+   resources
    changes
    contributing
    architecture

docs/resources.rst

@@ -0,0 +1,78 @@
+Resources
+=========
+
+This section includes resources that can be used to learn more about
+the Django Debug Toolbar.
+
+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.
+
+* `View the tutorial details on the conference website <https://2022.djangocon.us/tutorials/it-doesnt-work-a-djangonauts-debugging/>`__
+* `Follow along with the GitHub repository <https://github.com/tim-schilling/debug-tutorial/>`__
+* `View the slides on Google Docs <https://docs.google.com/presentation/d/1dmeFD5kGsukQaMinU0BJQyyCeu5ZGR4drc0pJilT10Y/edit?usp=share_link>`__
+* 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.
+
+* `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/>`__
+* `Watch on DjangoTV <https://djangotv.com/videos/djangocon-us/2024/a-related-matter-optimizing-your-webapp-by-using-django-debug-toolbar-with-christopher-adams/>`__
+* 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.
+
+* `View the talk details on the conference website <https://pretalx.evolutio.pt/djangocon-europe-2024/talk/QGLCYX/>`__
+* `Watch on DjangoTV <https://djangotv.com/videos/djangocon-europe/2024/djangocon-europe-2024-fast-on-my-machine-how-to-debug-slow-requests-in-production/>`__
+* Published: July 11, 2024.
+* Duration: 23 minutes.
+
+Want to Add Your Content Here?
+------------------------------
+
+Have a great tutorial or talk about Django Debug Toolbar? We'd love to
+showcase it! If your content helps developers improve their debugging skills,
+follow our :doc:`contributing guidelines <contributing>` to submit it.
+
+To ensure relevant and accessible content, please check the following
+before submitting:
+
+1. Does it at least partially focus on the Django Debug Toolbar?
+2. Does the content show a version of Django that is currently supported?
+3. What language is the tutorial in and what languages are the captions
+   available in?
+
+Talks and tutorials that cover advanced debugging techniques,
+performance optimization, and real-world applications are particularly
+welcome.