future proof docs

Author: gionn

.github/updatecli_maven_73_values.yml

@@ -2,4 +2,4 @@ updatecli_matrix_version: 7.3.N
 ansible_version_file: vars/acs73.yml
 artifacts:
   alfresco-audit-storage-app:
-    updatecli_matrix_component_key: false
+    updatecli_matrix_component_key: false # disabled because unsupported

.github/updatecli_maven_74_values.yml

@@ -2,4 +2,4 @@ updatecli_matrix_version: 7.4.N
 ansible_version_file: vars/acs74.yml
 artifacts:
   alfresco-audit-storage-app:
-    updatecli_matrix_component_key: false
+    updatecli_matrix_component_key: false # disabled because unsupported

.github/updatecli_maven_values.yml

@@ -1,6 +1,12 @@
 ansible_default_repository_name: private
 ansible_default_group_id: org.alfresco
 artifacts:
+  # example-artifact:
+  #   artifact_name_file: file where the artifact name can be retrieved
+  #   artifact_name_key: yaml path to the artifact name field
+  #   artifact_version_key: yaml path to the artifact version field (target file is set globally)
+  #   updatecli_matrix_component_key: component name in the supported matrix in alfresco-updatecli
+  #   artifact_group_id: optional, group id of the artifact if different from the default
   # alfresco-control-center:
   #   artifact_name_file: playbooks/group_vars/acc.yml
   #   artifact_name_key: $.acc_artifact_id

README.md

@@ -188,14 +188,22 @@ doc](./README.md#versioning)
 
 ## Release
 
-Follow this quick checklist:
+First ensure that the
+[supported-matrix](https://github.com/Alfresco/alfresco-updatecli/blob/master/deployments/values/supported-matrix.yaml)
+reflects the status of the currently released Alfresco products and update if
+necessary before proceeding.
+
+Follow the checklist:
 
 1. Review currently open dependabot/renovate and merge them.
 2. For minor releases, ensure to update the links beginning with
   `https://support.hyland.com/r/Alfresco` to reflect the latest version or
   corresponding minor update documentation.
 3. In case of a new ACS major version, copy the versions inside the group_vars/all.yml to a new XX.N-extra-vars.yml
-4. Bump versions constraints in scripts/updatecli/updatecli_acs*.yml (workflow will take care of the rest)
+4. Run the [updatecli
+   workflow](https://github.com/Alfresco/alfresco-ansible-deployment/actions/workflows/bumpVersions.yml)
+   against an existing branch to push bumps there or against `master` to push
+   the bumps to `updatecli-bump-versions` branch.
 5. Ensure that the [versions table in the main readme](docs/overview.md#versioning) has been updated
 6. Ensure that docker images and AMI id for the root molecule tests are
    reflecting any minor OS release (e.g. [default suite](../molecule/default/))