---
# System prepended metadata

title: esp-hal beta triage 13/01/2025

---

# 1.0.0-beta.0 Meeting

- `read_bytes` should be blocking on all drivers?
  - Should UART's `read_bytes` return errors? Or, if it should be blocking, should it return _why_ it stopped receiving (error, timeout, buffer filled up, ...?)
      - cc: https://github.com/esp-rs/esp-hal/pull/2935, https://github.com/esp-rs/esp-hal/pull/2882, https://github.com/esp-rs/esp-hal/issues/2807, https://github.com/esp-rs/esp-hal/issues/2730
- Possibly marking `transaction` as unstable: https://github.com/esp-rs/esp-hal/issues/2820#issuecomment-2583021949
- https://github.com/esp-rs/esp-hal/issues/1668

---

As justification for the below points, beta is fairly well-defined (e.g. https://en.wikipedia.org/wiki/Software_release_life_cycle) and we should honour this; labelling a release as beta is sending a message to users, which will set expectations. The important part here is (emphasis mine):

> A beta phase generally begins **when the software is feature-complete** but likely to contain several known or unknown bugs.

- There are still ~~22~~ 10 open issues with the investigation label
    - If we are unsure whether or not these issues involve breaking API changes, then we should not be moving forward with a beta release
    - https://github.com/esp-rs/esp-hal/issues?q=is%3Aopen+is%3Aissue+label%3Ainvestigation
- There are ~~13~~ 3 open issues with the `1.0-blocker` label which are on the `1.0.0-beta.0` milestone
    - If these are intended to be completed for the milestone, they should have the `beta-blocker` label instead to signify such
    - https://github.com/esp-rs/esp-hal/issues?q=is%3Aopen+is%3Aissue+label%3A1.0-blocker+milestone%3A1.0.0-beta.0
- There are ~~29~~ 33 open issues with the `1.0-blocker` label, and which are not part of the `1.0.0-beta.0` milestone and also do not have the `investigation` label; of these, *any* issues involving breaking API changes or adding new functionality should be completed as part of this milestone
    - https://github.com/esp-rs/esp-hal/issues?q=is%3Aopen+is%3Aissue+label%3A1.0-blocker+no%3Amilestone+-label%3Ainvestigation