3.17.0 Release notes

content/en/core/releases/3.17.0.md

@@ -0,0 +1,98 @@
+---
+title: "3.17.0 release notes"
+linkTitle: "3.17.0"
+weight:
+description: >
+relevantLinks: >
+toc_hide: true
+---
+
+## Known issues
+
+Check the repository for the [latest known issues](https://github.com/medic/cht-core/issues?q=is%3Aissue+label%3A%22Affects%3A+3.17.0%22).
+
+## Upgrade notes
+
+### Breaking changes
+
+None.
+
+### UI/UX changes
+
+#### Action button labels now show for all devices
+
+Action button labels now show on lower resolution phones, making it easier to understand what each action button does.
+
+![](../images/3.17.0-7721-action-buttons.png)
+
+- [#7721](https://github.com/medic/cht-core/issues/7721): Icon labels on action buttons are not showing at the default dp for commonly used mobile devices.
+
+#### Update to search and filters on the Contacts and Reports tabs
+
+Search and filters on the Contacts and Reports tabs have been updated to more closely align with Android UX and [material design patterns](https://material.io/). This is the first of several incremental UI/UX changes that will improve app learnability by providing a familiar user interface that is consistent with other Android apps. To learn more about the other planned material design UI/UX changes, check out [this forum post](https://forum.communityhealthtoolkit.org/t/updates-to-the-cht-ui-ux/1998).
+
+NOTE: The old version of the UI can be temporarily re-enabled by following the instructions [in the documentation]({{% ref "apps/features/reports#filters--search" %}}), but will be completely removed in a future release.
+
+![](../images/3.17.0-7653.png)
+
+
+- [#7653](https://github.com/medic/cht-core/issues/7653): Report's filter redesign.
+- [#7746](https://github.com/medic/cht-core/issues/7746): Search bar redesign.
+
+## Highlights
+
+### Places created with bulk upload now have a primary contact
+
+We have improved the [bulk upload]({{< ref "apps/guides/data/users-bulk-load" >}}) feature to automatically assign a primary contact to a newly created place.
+
+- [#7724](https://github.com/medic/cht-core/issues/7724): Places created with bulk upload don't have a primary contact.
+
+### Privacy policy is now public
+
+Android app submission now requires a URL to the apps' privacy policy. To facilitate this process we have made the [privacy policy]({{< ref "apps/guides/privacy/privacy-policy" >}}) public in the login page.
+
+![](../images/3.17.0-7662-privacy-policy.png)
+
+- [#7662](https://github.com/medic/cht-core/issues/7662): Expose privacy policy at a public URL.
+
+### Breadcrumbs improvement
+
+To improve clarity, breadcrumbs on the left-hand side list of the Messages and Reports tabs will no longer display the level the user themselves belongs to. Also, breadcrumbs have been added to the Tasks tab to make it easier to know which household the task subject belongs to.
+
+{{< figure src="../images/3.17.0-5697-messages.png" class="left col-6" >}}
+{{< figure src="../images/3.17.0-5697-reports.png" class="left col-6" >}}
+{{< figure src="../images/3.17.0-5710-tasks.png" class="col-6" >}}
+
+- [#5710](https://github.com/medic/cht-core/issues/5710): Add "belongs to" breadcrumbs to tasks on the left-hand side list.
+- [#5697](https://github.com/medic/cht-core/issues/5697): Update the levels displayed in breadcrumbs across the app.
+
+## Full list
+
+### Features
+
+- [#7653](https://github.com/medic/cht-core/issues/7653): Report's filter redesign.
+- [#7746](https://github.com/medic/cht-core/issues/7746): Search bar redesign.
+
+### Improvements
+
+- [#7662](https://github.com/medic/cht-core/issues/7662): Expose privacy policy at a public URL.
+- [#7724](https://github.com/medic/cht-core/issues/7724): Places created with bulk upload don't have a primary contact.
+- [#7721](https://github.com/medic/cht-core/issues/7721): Icon labels on action buttons are not showing at the default dp for commonly used mobile devices.
+- [#5710](https://github.com/medic/cht-core/issues/5710): Add "belongs to" breadcrumbs to tasks on the left hand side list.
+- [#5697](https://github.com/medic/cht-core/issues/5697): Update the levels displayed in breadcrumbs across the app.
+
+### Security fixes
+
+None.
+
+### Performance improvements
+
+None.
+
+### Bug fixes
+
+- [#6215](https://github.com/medic/cht-core/issues/6215): The can_edit permission doesn't stop you from editing documents.
+
+### Technical improvements
+
+None.

content/en/core/releases/_index.md

@@ -22,10 +22,11 @@ It is recommended that all projects update regularly multiple times a year to ge
 
 | Version | Status | Release date | End of life |
 |----|----|----|----|
-| 3.16.x  | Current | 3-Aug-2022 | TBA         |
-| 3.15.x  | Current | 4-May-2022 | 3-Nov-2022  |
-| 3.14.x | Current | 11-Feb-2022 | 4-Aug-2022 |
-| 3.13.x | Current | 29-Sep-2021 | 11-May-2022 |
+| 3.17.x  | Current | 11-Oct-2022 | TBA |
+| 3.16.x  | Current | 3-Aug-2022 | 11-Jan-2023 |
+| 3.15.x  | Current | 4-May-2022 | 3-Nov-2022 |
+| 3.14.x | EOL | 11-Feb-2022 | 4-Aug-2022 |
+| 3.13.x | EOL | 29-Sep-2021 | 11-May-2022 |
 | 3.12.x | EOL | 28-Jul-2021 | 29-Dec-2021 |
 | 3.11.x | EOL | 21-Apr-2021 | 28-Oct-2021 |
 | 3.10.x | EOL | 9-Sep-2020 | 21-Jul-2021 |
@@ -81,6 +82,7 @@ Devices with more navigation systems are more likely to get a more accurate loca
 ## Release Notes
 ### 3.x
 
+- [3.17.0]({{% ref "core/releases/3.17.0.md" %}})
 - [3.16.0]({{% ref "core/releases/3.16.0.md" %}})
 - [3.15.0]({{% ref "core/releases/3.15.0.md" %}})
 - [3.14.2]({{% ref "core/releases/3.14.2.md" %}})