v13: cleanup pass on notes

Author: fenekku

docs/maintenance/architecture/curation.md

@@ -1,5 +1,7 @@
 # Curation checks
 
+_Introduced in v13_
+
 **Intended audience**
 
 This guide is intended for maintainers and developers of InvenioRDM itself.

docs/operate/customize/require_community.md

@@ -1,5 +1,7 @@
 # Require community for record publication
 
+_Introduced in v13_
+
 Institutional policies may require all published records to belong to at least one community. InvenioRDM enforces this requirement through the `RDM_COMMUNITY_REQUIRED_TO_PUBLISH` configuration parameter.
 To activate this feature, open your `invenio.cfg` and add:
 

docs/operate/customize/vocabularies/funding.md

@@ -50,7 +50,7 @@ Create a new job called "Load Funders" in the Default queue with task "Load ROR
 sure to check the "active" checkbox and click the save button.
 
 Then click the "Configure and run" button, select the "celery" queue, and put
-"1900-01-01" in the "Since" field. Click "Run now" and your affiliations will
+"1900-01-01" in the "Since" field. Click "Run now" and your funders will
 be loaded.
 
 You can also use the "Schedule job" button to download the latest version of

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

@@ -130,6 +130,7 @@ Here is a quick summary of the myriad other improvements in this release:
 - Great improvements in bulk serialization performance
 - The communities REST endpoint accepts both UUID and slug in the URL
 - Many new configuration variables (e.g., `COMMUNITIES_SEARCH_SORT_BY_VERIFIED`) to tune your instance
+- The new `generator` HTML `meta` tag identifies the repository technology. This is used by services like [OpenDOAR](https://opendoar.ac.uk/) to correctly catalog open access repositories.
 - ...and many more bug fixes!
 
 ## Breaking changes

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

@@ -26,22 +26,6 @@ invenio-cli, version 1.8.0
     In case you are not inside a virtual environment, make sure that you prefix each `invenio`
     command with `pipenv run`.
 
-**Local development**
-
-Changing the Python version in your development environment highly
-depends on your setup, so we won't cover it here.
-One way would be to use [PyEnv](https://github.com/pyenv/pyenv).
-
-!!! warning "Risk of losing data"
-
-    Your virtual environment folder a.k.a., `venv` folder, may contain uploaded files. If you kept the default
-    location, it is in `<venv folder>/var/instance/data`. If you need to keep those files,
-    make sure you copy them over to the new `venv` folder in the same location.
-    The command `invenio files location list` shows the file upload location.
-
-If you upgraded your python version, you should recreate your virtual environment before
-running `invenio-cli` or `pipenv` commands below.
-
 ### Upgrade InvenioRDM
 
 #### Requirements
@@ -75,6 +59,13 @@ This approach will create a new virtual environment and leaves the v12 one as-is
 If you are using a docker image on your production instance this will be the
 option you choose.
 
+!!! warning "Risk of losing data"
+
+    Your virtual environment folder a.k.a., `venv` folder, may contain uploaded files. If you kept the default
+    location, it is in `<venv folder>/var/instance/data`. If you need to keep those files,
+    make sure you copy them over to the new `venv` folder in the same location.
+    The command `invenio files location list` shows the file upload location.
+
 ##### Step 1
 
 - create a new virtual environment
@@ -193,7 +184,7 @@ If you choose to delete and re-create your search cluster as part of the upgrade
 Be sure to repeat the [Rebuild search indices](#rebuild-search-indices) step to ensure your system is fully functional.
 
 #### Jobs
-The new Jobs feature uses a custom celery task scheduler which requires a separate celery beat. See the [related documentation](../../operate/customize/jobs.md#scheduler) on how to add it or [this change](https://github.com/inveniosoftware/cookiecutter-invenio-rdm/pull/314) in the InvenioRDM boilerplate for reference.
+The new Jobs feature uses a custom celery task scheduler which requires a separate celery beat. See the [related documentation](../../operate/customize/jobs.md#scheduler) or [the scheduler service](https://github.com/inveniosoftware/cookiecutter-invenio-rdm/blob/ff6c652091d56e7a8aa0a90487f91352f70c4e33/%7B%7Bcookiecutter.project_shortname%7D%7D/docker-compose.full.yml) in the InvenioRDM boilerplate for how to add it.
 
 !!! note
     Be sure to run this additional Celery beat scheduler in your production or deployed environments. Without it, scheduled and on-demand jobs will not be executed.
@@ -216,10 +207,17 @@ To resolve this, simply add a custom [`types`](https://nginx.org/en/docs/http/ng
 
 ### Optional changes
 
-#### Deprecated configurations
+#### Deprecations
+
+*`APP_ALLOWED_HOSTS`*
+
 With the upgrade to Flask version 3, the configuration variable `APP_ALLOWED_HOSTS` has been renamed to `TRUSTED_HOSTS`. The value remains unchanged.
 You should review your `invenio.cfg`, environment variables, and deployment configuration for any occurrences of the old variable name.
-It is recommended to update all references to `TRUSTED_HOSTS` to avoid deprecation warnings in the console.
+It is recommended to update all references to `TRUSTED_HOSTS` to avoid deprecation warnings in the console and prepare for its eventual complete removal.
+
+*`invenio_records_resources.services.Link`*
+
+Usage of `invenio_records_resources.services.Link` is deprecated in favor of `invenio_records_resources.services.EndpointLink` for InvenioRDM links and `invenio_records_resources.services.ExternalLink` for external third-party links. Replace instances of `Link` in your custom code, if any, appropriately. `Link` will be removed in a future major InvenioRDM release.
 
 #### Display versions in administration panel
 As described in the [release notes](./version-v13.0.0.md#miscellaneous-additions), you can now display the versions of your installed modules directly in the Administration panel.

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

@@ -2,7 +2,7 @@
 
 _2025-07-21_
 
-We're happy to announce the release of InvenioRDM v13.0! Version 13 will be maintained until at least 6 months following the next release. Visit our maintenance policy page to learn more.
+We're happy to announce the release of InvenioRDM v13.0, the open-source repository platform for research data management, institutional repositories, and digital assets management! Version 13 will be maintained until at least 6 months following the next release. Visit our [maintenance policy page](../maintenance-policy.md) to learn more.
 
 ## Try it
 
@@ -33,7 +33,8 @@ The new `Compare Revisions` feature allows administrators to audit record update
 You can learn how to compare records' revisions [here](../../use/administration.md#compare-revisions).
 
 ### Audit logs
-InvenioRDM now comes with a new audit logs feature. See the [related documentation here](../../operate/customize/audit-logs.md).
+InvenioRDM now comes with a [new audit logs feature](../../operate/customize/audit-logs.md) which allows administrators to track the history of actions surrounding a record such as creation, edits and publication.
+
 
 ![Administration Panel](../../operate/customize/imgs/audit-logs.png)
 
@@ -48,7 +49,7 @@ Communities can now have their own theming with a custom font and colors, which
 
 ![A default community and two themed communities on Zenodo](imgs/themed-communities.png)
 
-Themed communities benefit from a custom homepage, defined by changing its HTML template.
+Themed communities can have a custom homepage defined by overriding the default community homepage template.
 
 Read more about the [themes communities feature](../../operate/customize/look-and-feel/themed_communities.md).
 
@@ -68,15 +69,17 @@ Collections introduce a powerful new way to organize and curate records within y
 Collections provide dedicated pages showing all records matching specific criteria.
 ///
 
-**Hierarchical organization**
+*Hierarchical organization*
+
 Collections allow you to define hierarchical groupings of records, enabling users to browse content by subject, resource type, funding program, or any other metadata field.
 
 ![Community "Browse" tab showing hierachical collections based on subjects](imgs/collection-browse.png)
 /// caption
 The collection browser provides an organized view of all available collections within a community.
 ///
 
-**Common use cases**
+*Common use cases*
+
 - Group content by research disciplines using a hierarchical vocabulary
 - Organize historical records by publication date
 - Organize records by funding programs (Horizon 2020, NSF, institutional grants)
@@ -97,7 +100,7 @@ Curation checks in Zenodo's EU Open Research Repository
 
 Read the detailed documentation for [Curation checks](../../operate/customize/curation-checks.md).
 
-### Customizable compliance info when publishing
+### Customizable compliance information when publishing
 You can now fully customize the compliance information and checkboxes that users must acknowledge when publishing a record. This makes it easy to tailor the publishing workflow to your organization's policies or legal requirements.
 
 ![Publish modal with extra checkbox](../../operate/customize/imgs/compliance_checkboxes.png)
@@ -110,16 +113,16 @@ You can now let users to choose if they need a DOI or not when uploading. See ho
 ![DOIs on demand](../../operate/customize/imgs/dois-on-demand.jpg)
 
 ### Extra PIDs schemes
-InvenioRDM v13 allows you to extend the list of existing schemes for persistent identifiers to detect, validate and add support for your owns.
+InvenioRDM v13 allows you to extend the list of existing persistent identifier schemes to detect, validate and support any additional ones you want.
 
 ![Extra PID schemes](../../operate/customize/metadata/imgs/custom_pids_schemes.jpg)
 
-See the [related documentation](../../operate/customize/metadata/custom_pids_schemes.md) how to add your own custom schemes.
+See the [related documentation](../../operate/customize/metadata/custom_pids_schemes.md) for how to add your own custom schemes.
 
 Under the hood, the Invenio [idutils](https://github.com/inveniosoftware/idutils) module handles validation and normalization of persistent identifiers used in scholarly communication, and existing customizations may be affected by changes in v13. The module has been restructured to use a configurable scheme system with a new entrypoint mechanism for registering your own identifier schemes.
 
 ### FAIR Signposting
-With v13, you can now enable support for FAIR Signposting level 1 and 2. See [the related documentation](../../operate/customize/FAIR-signposting.md) for more information.
+With v13, you can now enable [support for FAIR Signposting level 1 and 2](../../operate/customize/FAIR-signposting.md) which increases the discoverability and citability of your repository's content.
 
 ### 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.
@@ -130,11 +133,11 @@ Learn more about [file uploaders](../../operate/customize/file-uploads/uploader.
 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).
 
 #### ORCID and ROR integrations
-You can now setup jobs to automatically and recurrently fetch ORCID and ROR latest databases.
+You can automatically and recurrently fetch and ingest the latest ORCID and ROR data by creating a job.
 
 For ORCID, read more on the [names vocabulary](../../operate/customize/vocabularies/names.md#using-orcid-public-data-sync) documentation page.
 
-With the ROR job, you can automatically load funders or affiliations vocabulary from the InvenioRDM administration panel, and schedule updates with new ROR releases. Instructions can be found on the [affiliations vocabulary](../../operate/customize/vocabularies/affiliations.md) documentation page.
+With the ROR job, you can automatically load the affiliations or funders vocabulary from the InvenioRDM administration panel, and schedule updates with new ROR releases. Instructions can be found on the [affiliations](../../operate/customize/vocabularies/affiliations.md) and [funding](../../operate/customize/vocabularies/funding.md) documentation pages respectively.
 We have also upgraded the integration with ROR to version 2.0 and enhanced the metadata to include organization aliases, status, types, locations, and acronyms, making it easier to find the correct organization or funders.
 
 #### EuroSciVoc subjects
@@ -159,7 +162,7 @@ We have introduced new metadata fields that will allow you to capture more usefu
 The v13 release features an upgraded PDF previewer, now powered by [PDF.js v4](https://github.com/mozilla/pdf.js). This update resolves previous issues with failed previews for certain PDF files, providing a more reliable and seamless viewing experience.
 
 ### Requests sharing
-When a record is shared, the review request is now also accessible. We have introduced a new search filter in `My Dashboard`, to easily find records shared with me.
+When a record is shared, the review request is now also accessible. We have introduced a new search filter in `My Dashboard`, to easily find records shared with you.
 
 ![Shared with me](./imgs/my-dashboard-shared-with-me.jpg)
 
@@ -169,12 +172,12 @@ Both users and records search have been enhanced to return more accurate results
 Creators, affiliations and funders autocompletion has been improved so that suggestions appear faster and better match what you type.
 
 ### Sitemaps
-InvenioRDM v13 introduces the automatic generation of sitemaps to help search engines and other crawlers discovering and indexing your repository's content. Sitemaps are even automatically linked in your `robots.txt`.
+InvenioRDM v13 introduces the automatic generation of sitemaps to help search engines and other crawlers discover and index your repository's content. Sitemaps are even automatically linked in your `robots.txt`.
 
-See the [related documentation](../../operate/customize/sitemaps.md) to learn how to configure it.
+See the [related documentation](../../operate/customize/sitemaps.md) to learn how to configure their generation.
 
 ### Miscellaneous additions
-Here is a quick summary of the myriad other improvements in this release:
+Here is a quick summary of the myriad of other improvements in this release:
 
 - A convenient "Copy" button has been added next to the DOI (when enabled) and export formats, allowing users to instantly copy these values to their clipboard with a single click without manually selecting or exporting the content:
   ![Copy button for DOI](imgs/copy-button-doi.jpg)
@@ -200,22 +203,25 @@ Here is a quick summary of the myriad other improvements in this release:
 - Following the [latest COUNTER spec](https://www.countermetrics.org/code-of-practice/), the [list of robots and machines](https://github.com/inveniosoftware/counter-robots) have been updated to ensure the stats are counted on human usage.
 - Logging: the Flask root logger level has been changed from `undefined` to `DEBUG`. This enables all log messages to pass through by default, instead of being blocked. If you have implemented custom logging handlers, ensure that you have defined the logging level and verify your logging verbosity in deployed environments to avoid excessive logs.
 - The issue related to storage quota per record for a given user has been solved. You can now define different storage quotas per record.
-- InvenioRDM v13 introduces the `generator` HTML `meta` tag to identify the repository technology. This is used by services like [OpenDOAR](https://opendoar.ac.uk/) to correctly catalog open access repositories.
-  The generator string will be `InvenioRDM v13.0`. You can change it in your `invenio.cfg` by overriding the variable `THEME_GENERATOR` or setting it to `None` to disable the meta tag.
 - MathJax: when enabled, it will now render mathematical formulas also in the landing page citation box, search results and request's comments pages.
+- Easier link generation: it's now possible to use `from invenio_base import invenio_url_for` to generate API links in the UI application and vice versa. When configuring services, `from invenio_records_resources.services import EndpointLink` now replaces `Link` which establishes a single source of truth for links.
 - ...and many more bug fixes!
 
-### Experimental
+## Experimental additions
 InvenioRDM v13 introduces experimental support for a modern development toolchain, including [uv](https://github.com/astral-sh/uv) (as a replacement for pipenv), [Rspack](https://www.rspack.dev/) (as a replacement for webpack), and [pnpm](https://pnpm.io/) (as a replacement for npm). These tools significantly improve the developer and system administration experience by offering faster installs, better performance, and more efficient workflows.
 
 These tools are **disabled by default** and will be tested further in the coming months. If you are interested in trying them out and providing feedback, please get in touch with the [maintainers team](https://github.com/orgs/inveniosoftware/teams/core-maintainers).
 
+## Deprecations
+- Direct Python imports of identifier schemes (e.g., `from idutils.isbn import normalize_isbn`) are now deprecated and will be removed in future versions. If you have custom code that directly imports scheme modules, you'll need to update it to use the new API.
+- Usage of `invenio_records_resources.services.Link` is deprecated in favor of `invenio_records_resources.services.EndpointLink` for InvenioRDM links and `invenio_records_resources.services.ExternalLink` for external third-party links. `Link` will be removed in a future major InvenioRDM release.
+
 ## Breaking changes
 - The minimum required OpenSearch version is now **v2.12**. This change is necessary due to a bug in earlier OpenSearch versions that affects the handling of `geo-shape` fields introduced in InvenioRDM v13. See the [upgrade guide](upgrade-v13.0.md#opensearch-version) for more information.
 - The new search improvements and the enhanced subjects and awards features require the recreation of the search mappings for Subjects, Awards, Records _(including percolators)_, Drafts and Communities. See the [upgrade guide](upgrade-v13.0.md#rebuild-search-indices) for more information.
 - The integration with the new ROR schema v2 requires to re-import both the affiliations and funders vocabularies. See the [upgrade guide](upgrade-v13.0.md#updated-affiliations-and-funders) for more information.
 - The upgrade of the PDF previewer requires a small change to the webserver configuration. See the [upgrade guide](upgrade-v13.0.md) for more information.
-- Direct Python imports of identifier schemes (e.g., `from idutils.isbn import normalize_isbn`) are now deprecated and will be removed in future versions. If you have custom code that directly imports scheme modules, you'll need to update it to use the new API.
+
 
 ## Requirements
 
@@ -243,7 +249,7 @@ The development work of this impressive release wouldn't have been possible with
 - Alex Ioannidis
 - Alzbeta Pokorna
 - Anika Churilova
-- Austin
+- Austin Sharp
 - Brian Kelly
 - Carlin MacKenzie
 - Christoph Ladurner
@@ -254,16 +260,13 @@ The development work of this impressive release wouldn't have been possible with
 - ducica
 - Eduard Nitu
 - Emil Dandanell Agerschou
-- enitu
 - Eric Newman
 - Eric Phetteplace
 - Esteban J. G. Gabancho
 - Fatimah Zulfiqar
 - Felipe Carlos
 - Florian Gantner
 - Furkan Kalkan
-- furkankalkan
-- Gantner, Florian Klaus
 - Guillaume Viger
 - Hrafn Malmquist
 - Ian W. Scott
@@ -276,7 +279,6 @@ The development work of this impressive release wouldn't have been possible with
 - Martin Fenner
 - Martin Obersteiner
 - Matt Carson
-- Max
 - Maximilian Moser
 - mb-wali
 - Michael Groh
@@ -288,15 +290,11 @@ The development work of this impressive release wouldn't have been possible with
 - Pablo Saiz
 - Pablo Tamarit
 - Panna Liptak
-- phette23
-- psaiz
-- rekt-hard
 - roll
 - Saksham Arora
 - Sam Arbid
 - Sarah Wiechers
 - Tom Morrell
-- utnapischtim
 - Werner Greßhoff
 - Will Riley
 - Yash Lamba