==============
 User's Guide
==============

Welcome to the ``mpl-visual-context`` User Guide! This guide provides detailed explanations, examples, and best practices to help you leverage the full potential of the library and enhance your Matplotlib visualizations.

Whether you're looking to apply complex visual effects, add contextual information to your plots, or streamline your plotting workflow, these guides are designed to walk you through the key features and functionalities. As the library grows, you'll find more guides here covering its various aspects.

.. toctree::
   :maxdepth: 1
   :caption: Guides:

   userguide-patheffects
   placeholder-for-imagebox-guide 
   placeholder-for-otherfeature-guide

.. note::
   The ``placeholder-for-imagebox-guide.rst`` and ``placeholder-for-otherfeature-guide.rst`` are not actual files yet. They are included to show how new guides would be added to the User Guide's table of contents. You can create these files when documentation for those components is ready. Remove these lines if you prefer not to have placeholders.


Further Reading & Examples
--------------------------

For a practical example of how advanced path effects from this library can be used in sophisticated Matplotlib plots, such as enhancing violin plots, you might find the following community blog post insightful:

* `Tutorial: Upgrading Violin Plots with mpl-visual-context style effects <https://leejjoon.github.io/jjl-mpl-blog/posts/mpl-20240324-upgrade-violin-plots/>`_
  (This post demonstrates concepts similar to those found in ``mpl-visual-context`` and was an inspiration for some features).