Guides
======

Guides are task-driven. Each page follows the same pattern: purpose,
prerequisites, sample case, runnable workflow, expected output,
interpretation, and next steps.

Start with :doc:`first-solve-python` for the main workflow. Use
:doc:`first-solve-cli` only when you want to copy maintained notebook assets
from a shell.

.. toctree::
   :maxdepth: 1

   first-solve-python
   first-solve-cli
   input-formats-and-validation
   zonal-and-total-site-workflows
   heat-pump-workflows
   heat-exchanger-network-synthesis
   cogeneration-workflows
   exergy-workflows
   graphing-and-interpretation
   exporting-results
   notebooks-and-sample-cases