# Action: Approval for the release of HSDS 3.2

**URL:** <https://forum.openreferral.org/t/action-approval-for-the-release-of-hsds-3-2/739>\
**Category:** Governance\
**Created:** [September 12, 2025, 7:02am UTC](https://forum.openreferral.org/t/action-approval-for-the-release-of-hsds-3-2/739 "2025-09-12T07:02:33Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![mrshll](https://avatars.discourse-cdn.com/v4/letter/m/57b2e6/32.png) [@mrshll](https://forum.openreferral.org/u/mrshll)\
**Post date:** [September 12, 2025, 7:02am UTC](https://forum.openreferral.org/t/action-approval-for-the-release-of-hsds-3-2/739/1 "2025-09-12T07:02:33Z")

</div>

Following the committee’s decision to approve a number of proposals on 2025-09-10, I have implemented the proposals and integrated them into a development branch called `3.2-dev` on Github, which is now available for review. There is an accompanying docs build for review as well.

- [3.2-dev on Github](https://github.com/openreferral/specification/tree/3.2-dev)
- [Docs build for 3.2-dev](http://docs.openreferral.org/en/3.2-dev/)

According to the [governance process](http://docs.openreferral.org/en/latest/about/specification-governance.html#major-and-minor-version-upgrades), I require approval from members of the Technical Committee to release this new version. Once it has been approved, the following will occur:

- I will wait until [PATCH 3.1.2](https://forum.openreferral.org/t/notification-of-patch-update-simple-schema-csv/738) has been merged into the `3.1` branch and then rebase `3.2-dev` on this, to ensure that we bring these changes through.
- I will change the branch name from `3.2-dev` to `3.2` and make it the default branch in the specification repo.
- I will issue a Github release using the tag `3.2`

To support review, please consult [the 3.2 changelog on the docs](http://docs.openreferral.org/en/3.2-dev/hsds/changelog.html) and compare these changes with what outlined in the following proposals (which were approved by the committee):

- [Proposal: Marking OpenAPI Endpoints with Tags to match the HSDS API Specification](https://forum.openreferral.org/t/proposal-marking-openapi-endpoints-with-tags-to-match-the-hsds-api-specification/735)
- [Proposal: API Field for Linking to Data Guides](https://forum.openreferral.org/t/proposal-api-field-for-linking-to-data-guides/734)
- [Proposal: Extra metadata with API Feeds](https://forum.openreferral.org/t/proposal-extra-metadata-with-api-feeds/733)

More git-inclined folks may want to inspect the actual changes to the schema files and the openapi files:

- [Comparison of 3.1 and 3.2-dev on Github](https://github.com/openreferral/specification/compare/3.1...3.2-dev) which will show the cumulative changes to files.

I would appreciate confirmation of approval in this forum thread, if possible.

---

<div class="post-metadata">

**Author:** ![MikeThacker-iStandUK](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.openreferral.org/mikethacker-istanduk/32/8_2.png) [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Post date:** [September 12, 2025, 12:52pm UTC](https://forum.openreferral.org/t/action-approval-for-the-release-of-hsds-3-2/739/2 "2025-09-12T12:52:34Z")

</div>

This is approved by me.

---

<div class="post-metadata">

**Author:** ![mrshll](https://avatars.discourse-cdn.com/v4/letter/m/57b2e6/32.png) [@mrshll](https://forum.openreferral.org/u/mrshll)\
**Post date:** [September 17, 2025, 7:47am UTC](https://forum.openreferral.org/t/action-approval-for-the-release-of-hsds-3-2/739/3 "2025-09-17T07:47:16Z")

</div>

Fantastic, cheers @MikeThacker-iStandUK

As of this morning I have merged the PATCH into the 3.2-dev branch and re-rolled it. I’ll be doing some due diligence to ensure that everything is as it should be, and then I’m happy to issue the release either later this week or early next week 🙂

---

<div class="post-metadata">

**Author:** ![skyleryoung](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.openreferral.org/skyleryoung/32/212_2.png) [@skyleryoung](https://forum.openreferral.org/u/skyleryoung)\
**Post date:** [October 9, 2025, 9:02pm UTC](https://forum.openreferral.org/t/action-approval-for-the-release-of-hsds-3-2/739/4 "2025-10-09T21:02:10Z")

</div>

Post must be at least 20 characters

Approved 😉

---

<div class="post-metadata">

**Author:** ![mrshll](https://avatars.discourse-cdn.com/v4/letter/m/57b2e6/32.png) [@mrshll](https://forum.openreferral.org/u/mrshll)\
**Post date:** [October 16, 2025, 8:39am UTC](https://forum.openreferral.org/t/action-approval-for-the-release-of-hsds-3-2/739/5 "2025-10-16T08:39:24Z")

</div>

Hi folks!

After illness-induced delays, I have released v3.2!

- [v3.2](https://github.com/openreferral/specification/releases/tag/v3.2)

The default branch for the specification repo is now `3.2`, and the `latest` branch of Readthedocs now points towards it. Remember that the docs are a static site, so you might need to do a hard refresh with `Ctrl+R` (`Cmd + R` for macOS users) to skip the caches and see the changes 🙂

---

<div class="post-metadata">

**Author:** ![devin](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.openreferral.org/devin/32/16_2.png) [@devin](https://forum.openreferral.org/u/devin)\
**Post date:** [October 16, 2025, 7:20pm UTC](https://forum.openreferral.org/t/action-approval-for-the-release-of-hsds-3-2/739/6 "2025-10-16T19:20:39Z")

</div>

I approve as welllllllll
