# DSS-DMDU

> **Distribution System Simulation under Deep Uncertainty**  
> A research framework for distribution system planning with heat pumps, EVs, PV, and storage.

```{toctree}
:hidden:
:maxdepth: 2
intro
install
workflow
outputs
examples
troubleshooting
glossary
```

## Quick Links

- **Start here:** {doc}`intro`
- **Install/Build docs:** {doc}`install`
- **Run the full workflow:** {doc}`workflow`
- **Understand results:** {doc}`outputs`
- **Examples:** {doc}`examples`
- **Troubleshooting:** {doc}`troubleshooting`

```{admonition} About
:class: tip
This site is built with **Sphinx** + **MyST Markdown** and hosted on **Read the Docs**.
```