User Stories
============

This section contains user stories that describe the high-level goals and needs
of stakeholders for the ESP32 Distance Sensor project.

User stories follow the format:
*"As a [role], I want [capability], so that [benefit]."*

.. toctree::
   :maxdepth: 2
   :caption: User Stories:

   us_display
   us_setup
   us_reliable
   us_developer

Overview
--------

User stories capture **who** needs **what** and **why**. They bridge stakeholder
needs to formal requirements.

* **Traceable** - Each user story links to requirements in :doc:`../11_requirements/index`
* **Role-based** - Organized by stakeholder type
* **Outcome-focused** - Describe value, not implementation

User Story IDs follow the pattern ``US_<AREA>_<NUMBER>``
(e.g., ``US_HW_1``, ``US_WEB_1``, ``US_CFG_1``).

Stakeholder Roles
-----------------

* **Garage user** - End user parking a car using the distance display
* **Maker / builder** - Developer assembling and configuring the hardware
* **Developer** - Engineer extending or maintaining the firmware
* **Workshop participant** - Learner following guided workshop exercises