###########################
Support and Troubleshooting
###########################

Need help using MUIOGO, planning work, or reporting a problem? Use the
repository channels based on the kind of help you need.

Community and Planning Questions
+++++++++++++++++++++++++++++++++

Use `GitHub Discussions <https://github.com/EAPD-DRB/MUIOGO/discussions>`_ for:

* planning questions
* general questions about the project
* community conversation
* early discussion before opening implementation pull requests

Discussions are the right place to ask questions, compare approaches, and sort
out scope before work turns into a PR.

Bugs, Blockers, and Actionable Work
+++++++++++++++++++++++++++++++++++

Use the `GitHub Issue Tracker <https://github.com/EAPD-DRB/MUIOGO/issues>`_ for:

* reproducible bugs
* scoped feature or task proposals
* blockers that need a concrete decision
* actionable follow-up work

Please use the relevant issue template and include enough detail to make the
problem easy to understand and triage.

What To Include
+++++++++++++++++++++++++++++++++

When reporting a bug or blocker, include:

* a clear problem statement
* expected behavior
* reproduction steps
* environment details such as OS, Python version, and branch or commit when
  relevant
* logs or screenshots when helpful

If the issue depends on prior work, list the related issues, pull requests, or
discussions you already checked.
