release: add 4.10.0 release notes (#1489)

* Add 4.10.0 release notes

* Update content/en/core/releases/4.10.0.md

Co-authored-by: Gareth Bowen <[email protected]>

* Update content/en/core/releases/4.10.0.md

Co-authored-by: Gareth Bowen <[email protected]>

* Update EOL for 4.9.0 release

* Update content/en/core/releases/4.10.0.md

Co-authored-by: Gareth Bowen <[email protected]>

---------

Co-authored-by: Gareth Bowen <[email protected]>

content/en/core/releases/4.10.0.md

@@ -0,0 +1,124 @@
+---
+title: "4.10.0 release notes"
+linkTitle: "4.10.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+4.10.0%22).
+
+## Upgrade notes
+
+### Breaking changes
+
+None.
+
+### UI/UX changes
+
+This release includes two improvements to [Aggregate Targets](https://docs.communityhealthtoolkit.org/apps/features/supervision/#chw-aggregate-targets). 
+
+- Users can now view data for the previous reporting period
+- Users [assigned multiple places](https://docs.communityhealthtoolkit.org/core/releases/4.9.0/#uiux-changes) can now see Aggregate Targets
+
+
+## Highlights
+
+### Aggregate Targets can now be viewed for the previous month
+The CHT now supports viewing Aggregate Targets for the previous month. All users who have access to Aggregate Targets will see a Filter option that allows them to choose between the current month and previous month. This affects both “monthly” and “all time” [widgets](https://docs.communityhealthtoolkit.org/apps/features/targets/#types-of-widgets). Viewing the previous month’s data for an “all time” widget (which is cumulative) will show the data as it were at the end of the previous month. When “Previous Month” is selected, a visual cue (the month name) will be displayed both in the list view (as a breadcrumb) and the detail view (as the column header).
+
+##### Details
+- “Current month” will always be shown by default
+- The “Reporting Period” label in the filter sidebar uses the  `analytics.target.aggregates.reporting_period` translation key
+- This filter is shown for all users who have access to aggregate targets, you don’t need to do anything to enable it (and there is no way to disable it)
+
+{{< figure src="../images/4.10.0-aggregate-targets.png">}}
+
+### Aggregate Targets for users assigned to multiple places
+The CHT also now supports Aggregate Targets for users that are assigned to multiple places. If a user has multiple places (added in 4.9.0), they will see an additional filter option that allows them to choose which place they want to view. There is also a visual cue on each Target to clearly indicate which place is being viewed.
+
+_NOTE: Users who are assigned only one place will not see the additional place filter option, but they will continue to see the new Reporting Period filter option._
+
+##### Details
+- The list of places will be shown alphabetically
+- The first place in the list will be selected by default
+- Only one place can be selected at a time (it’s not a multi-select)
+- The label / heading for the list of places in the filter sidebar is the [name_key](https://docs.communityhealthtoolkit.org/apps/reference/app-settings/hierarchy/#app_settingsjson-contact_types) of the place `contact type` as set in [app_settings](https://docs.communityhealthtoolkit.org/apps/reference/app-settings/)
+- This filter is shown for all users who have access to aggregate targets and are configured with multiple places, you don’t need to do anything to enable it (and there is no way to disable it)
+
+{{< figure src="../images/4.10.0-aggregate-targets-2.png">}}
+
+### Form validation for Luhn identifiers
+
+[Luhn numbers](https://en.wikipedia.org/wiki/Luhn_algorithm) are used in a range of identification schemes and include a check digit to allow validation so they can be checked for common mistakes like typos. Including this in xpath means this can be checked while the form is being filled out to detect mistakes before the form is completed. More information is available in the [xpath documentation](https://docs.communityhealthtoolkit.org/apps/reference/forms/app/#chtvalidate-luhn).
+
+[#9227](https://github.com/medic/cht-core/issues/9227): Include xpath function for validation of Luhn identifiers
+
+## And more...
+
+### Features
+
+- [#9194](https://github.com/medic/cht-core/issues/9194): API Endpoint for getting place by UUID
+- [#9227](https://github.com/medic/cht-core/issues/9227): Include xpath function for validation of Luhn identifiers
+
+### Improvements
+
+- [#8461](https://github.com/medic/cht-core/issues/8461): Client side error log under contacts
+- [#9231](https://github.com/medic/cht-core/issues/9231): Allow users to view aggregate targets and filter by facility_id and reporting period
+
+### Security fixes
+
+None.
+
+### Performance improvements
+
+None.
+
+### Bug fixes
+
+- [#9156](https://github.com/medic/cht-core/issues/9156): Submitter name is duplicated on the Reports Page | Detail View
+- [#9212](https://github.com/medic/cht-core/issues/9212): The "View all" filter of the History section on the Contact Page | Detail View is not working correctly
+- [#9226](https://github.com/medic/cht-core/issues/9226): Telemetry record for task:refresh isn't resetting the start time
+- [#9229](https://github.com/medic/cht-core/issues/9229): Old action bar should prevent users with multiple facilities assigned from editing the homeplace
+- [#9243](https://github.com/medic/cht-core/issues/9243): CHT Docker Helper for 4.x fails to install the TLS certificate
+- [#9264](https://github.com/medic/cht-core/issues/9264): Contact detail's telemetry is not recording the contact's type in default config. 
+- [#9265](https://github.com/medic/cht-core/issues/9265): Contact Details load facilities when user has one home place assigned
+- [#9275](https://github.com/medic/cht-core/issues/9275): The text on the Analytics Filter dropdown does not update
+- [#9284](https://github.com/medic/cht-core/issues/9284): CouchDb restart causes all services to go down
+- [#9298](https://github.com/medic/cht-core/issues/9298): CouchDb error on indexing telemetry documents
+
+### Technical improvements
+
+- [#8699](https://github.com/medic/cht-core/issues/8699): Clean and organize e2e tests: folder /contacts
+- [#9081](https://github.com/medic/cht-core/issues/9081): Add environment shared library
+- [#9106](https://github.com/medic/cht-core/issues/9106): Investigate moving common dependencies to root to make updates easier
+- [#9172](https://github.com/medic/cht-core/issues/9172): Add linting to ensure translations are complete and correct for supported languages
+- [#9191](https://github.com/medic/cht-core/issues/9191): Upgrade from latest release test fails for patch releases
+- [#9218](https://github.com/medic/cht-core/issues/9218): Upgrade e2e tests fails on minor releases 
+- [#9257](https://github.com/medic/cht-core/issues/9257): Organize the upgrade test suite
+- [#9302](https://github.com/medic/cht-core/issues/9302): Consolidate angular dependencies
+- [#9315](https://github.com/medic/cht-core/issues/9315): Validation test is failing silently
+- [#9320](https://github.com/medic/cht-core/issues/9320): Update dependabot configuration for dependencies at root level
+
+
+
+## Contributors
+
+Thanks to all who committed changes for this release!
+
+- [Gareth Bowen](https://github.com/garethbowen)
+- [Mokhtar](https://github.com/m5r)
+- [Jennifer Q](https://github.com/latin-panda)
+- [Ben Kiarie](https://github.com/Benmuiruri)
+- [Tatiana Lépiz Soto](https://github.com/tatilepizs)
+- [Joshua Kuestersteffen](https://github.com/jkuester)
+- [Jonathan](https://github.com/jonathanbataire)
+- [Diana Barsan](https://github.com/dianabarsan)
+- [ChinHairSaintClair](https://github.com/ChinHairSaintClair)
+- [Lore](https://github.com/lorerod)
+- [mrjones](https://github.com/mrjones-plip)
+- [Sugat Bajracharya](https://github.com/sugat009)
+

content/en/core/releases/_index.md

@@ -22,7 +22,8 @@ It is recommended that all projects update regularly multiple times a year to ge
 
 | Version | Status    | Release date | End of life |
 |---------|-----------|--------------|-------------|
-| 4.9.x   | Current   | 25-Jun-2024  | TBA         |
+| 4.10.x  | Supported | 15-Aug-2024  | TBA         |
+| 4.9.x   | Supported | 25-Jun-2024  | 15-Nov-2024 |
 | 4.8.x   | Supported | 22-May-2024  | 25-Sep-2024 |
 | 4.7.x   | Supported | 07-May-2024  | 22-Aug-2024 |
 | 4.6.x   | Supported | 20-Mar-2024  | 10-Aug-2024 |
@@ -94,6 +95,7 @@ Devices with more navigation systems are more likely to get a more accurate loca
 
 ### 4.x
 
+- [4.10.0]({{% ref "core/releases/4.10.0.md" %}})
 - [4.9.0]({{% ref "core/releases/4.9.0.md" %}})
 - [4.8.1]({{% ref "core/releases/4.8.1.md" %}})
 - [4.8.0]({{% ref "core/releases/4.8.0.md" %}})