diff --git a/docs/hsds/changelog.md b/docs/hsds/changelog.md
index a0a92c9..79ee9a8 100644
--- a/docs/hsds/changelog.md
+++ b/docs/hsds/changelog.md
@@ -5,8 +5,10 @@ This page provides the list of changes that have been made to the HSDS schema.
 
 ## [v3.1.1](https://github.com/openreferral/specification/releases/tag/v3.1.1)
 
-* Made Page.empty a required field for API responses
-
+* Made `Page.Empty` a required field for API responses
+* Fixed bad foreign keys and missing values in some example data 
+* Set `service_capacity.updated.datapackage_type` to `datetime`
+* Set `constraints` for fields in `unit` and `service_capacity` schemas 
 
 ## [v3.1](https://github.com/openreferral/specification/releases/tag/v3.1)
 
@@ -75,7 +77,7 @@ This page provides the list of changes that have been made to the HSDS schema.
     * added `minimum_age` and `maximum_age`
 * For `organization`
     * added `logo`
-    * added `parent_oranization_id`
+    * added `parent_organization_id`
     * added `uri`
     * added `website`
 * `organization_identifier` entity added
diff --git a/docs/index.md b/docs/index.md
index 0ada371..6f2e3cf 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -28,14 +28,6 @@ This documentation also provides materials about the Open Referral Initiative it
 
 The contents of the *About the Open Referral Initiative* section may be of interest for those looking to understand more about the wider Open Referral project as well as other standards which are relevant to HSDS.
 
-### Comment on our docs using Hypothes.is
-
-This documentation supports community comments via [Hypothes.is](https://web.hypothes.is/).
-
-Hypothes.is is an annotation service embedded into this documentation site. You may notice some text highlighted in yellow, or the button in the top right of each page which reveals the list of annotations for that page.
-
-To get involved in annotating the documentation, you'll need to create an account at Hypothes.is, but it's otherwise as simple as highlighting some text on the page and using the pop-up box to add your comments.
-
 ## Our ecosystem
 
 **Open Referral’s ecosystem** includes a range of working open source software applications that can be freely redeployed to work with HSDS-compatible data and/or APIs. Many of these tools can be found in [our Github organization](http://github.com/openreferral).