.. include:: ./substitutions.rst Troubleshooting --------------- 1. If you encounter errors when running |name|, first ensure that all the :ref:`required packages ` are up-to-date, then try again. 2. Check if this is one of the known open |issues|. You can also check the fixed issues `here `_. 3. If you still can't figure out what's wrong, please `submit a new issue on the Github repository of the project `_. Provide as much detail as possible: * |name| version * error message * minimal example * operating system * Python version * ...