v12/v13: better doc for new config vars

Author: ntarocco

docs/operate/customize/dois.md

@@ -77,7 +77,7 @@ DATACITE_FORMAT = "{prefix}/inveniordm.{id}"
 #### OAI-PMH
 
 The OAI-PMH server's metadata format ``oai_datacite`` that allows your records
-to be harvested in DataCite XML needs to be configured with your DataCite data 
+to be harvested in DataCite XML needs to be configured with your DataCite data
 center symbol. This is only required if you want your records to be harvestable in DataCite XML format.
 
 ```python
@@ -86,10 +86,10 @@ DATACITE_DATACENTER_SYMBOL = "CERN.INVENIORDM"
 
 ### Versioning and externally managed DOI
 
-By default, InvenioRDM allows versioning for any DOI type - internally or externally managed. 
-Internally managed DOIs are DOIs registered by your instance and minted on Datacite. 
-External DOIs are DOIs already minted and simply passed to your instance. 
-As such, having an internally managed DOI for the next version of a record with an external DOI may not be desired. 
+By default, InvenioRDM allows versioning for any DOI type - internally or externally managed.
+Internally managed DOIs are DOIs registered by your instance and minted on Datacite.
+External DOIs are DOIs already minted and simply passed to your instance.
+As such, having an internally managed DOI for the next version of a record with an external DOI may not be desired.
 To disable versioning for external DOIs you need to set
 
 ```python
@@ -147,7 +147,7 @@ RDM_PERSISTENT_IDENTIFIERS = {
     },
 }
 ```
-You [can view the default configuration for `RDM_PERSISTENT_IDENTIFIERS` in invenio-rdm-records](https://github.com/inveniosoftware/invenio-rdm-records/blob/master/invenio_rdm_records/config.py)
+You [can inspect here](https://github.com/inveniosoftware/invenio-rdm-records/blob/master/invenio_rdm_records/config.py#L393) the default configuration for `RDM_PERSISTENT_IDENTIFIERS`.
 
 ### Optional DOI User Interface and Advanced Configuration
 
@@ -159,7 +159,31 @@ InvenioRDM now includes a user interface to allow users to choose whether or not
 
 This will display when both main and parent DOIs are configured as
 optional. You can also set the default button selection with the
-"doi" "ui" "default_selected" option, which can be "yes", "no" or "not_needed"
+"doi" "ui" "default_selected" option, which can be "yes", "no" or "not_needed". In your `invenio.cfg`, change:
+
+```diff
+ RDM_PARENT_PERSISTENT_IDENTIFIERS = {
+     ...
+     "doi": {
+         ...
+-        "required": True,
++        "required": False,
+         ...
+     },
+     ...
+ }
+ RDM_PERSISTENT_IDENTIFIERS = {
+     ...
+     "doi": {
+         ...
+-        "required": True,
++        "required": False,
+         ...
+         "ui": {"default_selected": "yes"},  # "yes", "no" or "not_needed"
+     },
+     ...
+ }
+```
 
 With this option enabled, users can decide whether or not to request a DOI for their record. However, managing different versions of a record with and without DOIs can introduce complexities. Ideally, once a DOI is registered for a record, all subsequent versions should also have a DOI to avoid resolving to a version with a DOI, and creating confusion.
 

docs/releases/v12/upgrade-v12.0.md

@@ -172,10 +172,11 @@ invenio domains create spammer
 
 ### New configuration variables
 
-```bash
-COMMUNITIES_IDENTITIES_CACHE_REDIS_URL = "URI_TO_REDIS"
-USERS_RESOURCES_ADMINISTRATION_ENABLED = True
-THEME_SITENAME = "Project name for header and UI"
+These are the new configuration variables introduced in this release. Add them to your `invenio.cfg` as needed:
+
+```python
+COMMUNITIES_IDENTITIES_CACHE_REDIS_URL = "URI_TO_REDIS"  # Redis URL for caching community identities
+USERS_RESOURCES_ADMINISTRATION_ENABLED = True            # Enables the users administration panel
 ```
 
 ## Big Changes

docs/releases/v13/upgrade-v13.0.md

@@ -241,3 +241,18 @@ Failing to apply these changes may result in errors when accessing certain recor
 
 #### Enhanced File Uploader (Uppy)
 If you plan to use the new Uppy file uploader, ensure that your Content Security Policy (CSP) settings are updated in your `invenio.cfg` as described in the [enhanced file uploader documentation](../../operate/customize/file-uploads/uploader.md#enhanced-file-uploader-uppy). Failing to update your CSP rules may prevent the uploader from functioning correctly.
+
+#### New configuration variables
+
+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:
+
+```python
+# Enable FAIR Signposting
+APP_RDM_RECORD_LANDING_PAGE_FAIR_SIGNPOSTING_LEVEL_1_ENABLED = True
+# Enable Audit Logs
+AUDIT_LOGS_ENABLED = True
+# Manual setup required: enable Curation Checks
+CHECKS_ENABLED = True
+# Experiments: enable the new Uppy file uploader
+APP_RDM_DEPOSIT_NG_FILES_UI_ENABLED = True
+```

docs/releases/v13/version-v13.0.0.md

@@ -124,7 +124,7 @@ With v13, you can now enable support for FAIR Signposting level 1 and 2. See [th
 ### Files uploader & S3-compatible storage
 The new file uploader, powered by Uppy (disabled by default), delivers a faster, more intuitive, and modern file upload experience. It also enables advanced features such as **multipart file transfers** with **S3-compatible** storage backends.
 
-Learn more about [file uploaders](../../operate/customize/file-uploads/uploader.md), [S3-compatible storage](../../operate/customize/file-uploads/s3.md), and [file transfers](../../reference/file_transfer.md)
+Learn more about [file uploaders](../../operate/customize/file-uploads/uploader.md), [S3-compatible storage](../../operate/customize/file-uploads/s3.md), and [file transfers](../../reference/file_transfer.md).
 
 ### Jobs
 This release introduces a new Jobs feature, providing a comprehensive way to manage asynchronous tasks via the UI or REST API. Jobs are triggered via the admin UI or REST API, run using Celery, and support logging, argument validation, and result tracking. See the related documentation [here](../../use/administration.md#jobs).