identifiers: added related identifiers config var

Author: 0einstein0

docs/releases/vNext/upgrade-vNext.md

@@ -17,8 +17,8 @@ InvenioRDM v13.
     Always backup your database, statistics indices and files before you try to perform an upgrade.
 
 !!! info "Older Versions"
-    If your InvenioRDM installation is older than v13, you must first upgrade
-    to v13 before proceeding with the steps in this guide.
+If your InvenioRDM installation is older than v13, you must first upgrade
+to v13 before proceeding with the steps in this guide.
 
 ## Upgrade Steps
 
@@ -38,12 +38,13 @@ invenio-cli, version 1.9.0
 ### Upgrade InvenioRDM
 
 #### Requirements
+
 Python 3.9 or 3.11 or 3.12 is required to run InvenioRDM v13.
 
 !!! info "Python 3.9 end-of-life"
-    Official support for Python 3.9 will end on October 31, 2025.
-    See the [official Python version status page](https://devguide.python.org/versions/) for more information.
-    Future releases of InvenioRDM will require a more recent Python version.
+Official support for Python 3.9 will end on October 31, 2025.
+See the [official Python version status page](https://devguide.python.org/versions/) for more information.
+Future releases of InvenioRDM will require a more recent Python version.
 
 The minimum required OpenSearch version is now **v2.12**. See [below](#opensearch-version) on how to upgrade older versions.
 
@@ -52,20 +53,20 @@ The minimum required OpenSearch version is now **v2.12**. See [below](#opensearc
 To start using the new Record Deletion feature, one needs to go through the following steps during deployment:
 
 1. Update mappings and removal reasons vocabulary using new code in a terminal
-    - Update mappings
-        - Records and drafts have a `tombstone.deletion_policy` (optional) field
-            - `invenio index update --no-check rdmrecords-records-record-v7.0.0`
-            - `invenio index update --no-check rdmrecords-drafts-draft-v6.0.0`
-        - Update OAI-PMH precolators index for records (see [recipe below](#oai-pmh-percolator-mapping-update))
-        - Update request mappings to add the `last_reply` and `last_activity_at` fields
-            - `invenio index update --no-check requests-request-v1.0.0`
-    - Apply the [`invenio_request@1759321170` alembic migration](https://github.com/inveniosoftware/invenio-requests/blob/master/invenio_requests/alembic/1759321170_add_index_to_request_events_request_id_.py)
-        - `invenio alembic upgrade invenio_requests@1759321170` (or just `invenio alembic upgrade` if you're doing a full upgrade)
-    - Update removal reasons vocabulary to add `request-deletion` tags
-        - `invenio rdm-records add-to-fixture removalreasons`
-3. Deploy code to the rest of web and workers
-4. Reindex all requests to populate the `last_reply` and `last_activity_at` fields
-    - `invenio rdm-records rebuild-all-indices --order requests`
+   - Update mappings
+     - Records and drafts have a `tombstone.deletion_policy` (optional) field
+       - `invenio index update --no-check rdmrecords-records-record-v7.0.0`
+       - `invenio index update --no-check rdmrecords-drafts-draft-v6.0.0`
+     - Update OAI-PMH precolators index for records (see [recipe below](#oai-pmh-percolator-mapping-update))
+     - Update request mappings to add the `last_reply` and `last_activity_at` fields
+       - `invenio index update --no-check requests-request-v1.0.0`
+   - Apply the [`invenio_request@1759321170` alembic migration](https://github.com/inveniosoftware/invenio-requests/blob/master/invenio_requests/alembic/1759321170_add_index_to_request_events_request_id_.py)
+     - `invenio alembic upgrade invenio_requests@1759321170` (or just `invenio alembic upgrade` if you're doing a full upgrade)
+   - Update removal reasons vocabulary to add `request-deletion` tags
+     - `invenio rdm-records add-to-fixture removalreasons`
+2. Deploy code to the rest of web and workers
+3. Reindex all requests to populate the `last_reply` and `last_activity_at` fields
+   - `invenio rdm-records rebuild-all-indices --order requests`
 
 ##### OAI-PMH percolator mapping update
 
@@ -103,6 +104,7 @@ oaipmh_service.rebuild_index(identity=system_identity)
 ```
 
 #### Upgrade option 1: In-place
+
 This approach upgrades the dependencies in place. At the end of the process,
 your virtual environment for the v13 version will be completely replaced
 with the vNext environment and dependencies.
@@ -176,7 +178,7 @@ source <path to virtualenvs>/bin/activate
 This step ensures that all subsequent commands use the correct Python environment and installed dependencies.
 
 !!! note
-    If you are upgrading in an environment that does not use a Python virtualenv, you can skip this step.
+If you are upgrading in an environment that does not use a Python virtualenv, you can skip this step.
 
 ### Database migration
 
@@ -210,13 +212,12 @@ From v12 onwards, search indices for statistics (record's views and downloads) a
 affected by `invenio index destroy --yes-i-know` and are totally functional after the rebuild step.
 
 !!! info "Permission issue"
-    If you encounter an error similar to this when indexing:
-    ```
-    opensearchpy.exceptions.AuthorizationException: AuthorizationException(403, 'security_exception', 'no permissions for [cluster:admin/component_template/put] and User [name=<my-name>, backend_roles=[], requestedTenant=null]')
+If you encounter an error similar to this when indexing:
+`    opensearchpy.exceptions.AuthorizationException: AuthorizationException(403, 'security_exception', 'no permissions for [cluster:admin/component_template/put] and User [name=<my-name>, backend_roles=[], requestedTenant=null]')
     opensearchpy.exceptions.AuthorizationException: AuthorizationException(403, 'security_exception', 'no permissions for [indices:admin/index_template/put] and User [name=<my-name>, backend_roles=[], requestedTenant=null]')
-    ```
-    This means your OpenSearch user does not have sufficient permissions to create or update index templates.
-    To resolve this, grant the necessary permissions to your user in the OpenSearch cluster:
+   `
+This means your OpenSearch user does not have sufficient permissions to create or update index templates.
+To resolve this, grant the necessary permissions to your user in the OpenSearch cluster:
 
       1. Go to **OpenSearch Dashboards** -> **Security** -> **Roles** -> *<your role name>*.
       2. Edit the role and add the following cluster and index permissions:
@@ -247,3 +248,6 @@ Many [custom field widgets](../../operate/customize/metadata/custom_fields/widge
 
 These are the new configuration variables introduced in this release. Make sure that you read the related documentation before enabling them. Add them to your `invenio.cfg` as needed:
 
+##### Related Identifiers
+
+Backend and frontend functionality has been extended to cover related identifiers. The new `RDM_RECORDS_RELATED_IDENTIFIERS_SCHEMES` setting defines which schemes can be used (defaulting to `RDM_RECORDS_IDENTIFIERS_SCHEMES`). Validation rules, vocabularies in the UI, and scheme label resolution have been updated to ensure identifiers and related identifiers are handled consistently.

docs/releases/vNext/version-vNext.md

@@ -30,10 +30,12 @@ This feature is also [highly customisable](../../operate/customize/record_deleti
 https://github.com/inveniosoftware/invenio-previewer/pull/224
 
 ### Miscellaneous additions
+
 Here is a quick summary of the myriad of other improvements in this release:
 
 - Admin panel Jobs: Added a "Delete" action to the Jobs list so admins can remove jobs directly from the UI.
 - Temporarily pinned `bcrypt<5.0.0` due to compatibility issues ([flask-security-fork#82](https://github.com/inveniosoftware/flask-security-fork/pull/82)). Will be lifted in a future release.
+- A new configuration variable, `RDM_RECORDS_RELATED_IDENTIFIERS_SCHEMES`, enables configuring identifier schemes specifically for related identifiers, defaulting to `RDM_RECORDS_IDENTIFIERS_SCHEMES` when not defined.
 
 ## Deprecations
 
@@ -63,4 +65,3 @@ If you have questions related to these release notes, don't hesitate to jump on
 ## Credit
 
 The development work of this impressive release wouldn't have been possible without the help of these great people (name or GitHub handle, alphabetically sorted):
-