Harvesting: Clarify recordIdPath change in GN > 4.2.2

[tkohr]

PR clarifies documentation of recordIdPath property for harvesting via a simple URL harvester.

[fgravin]

Thanks for clarification and thanks @fxprunayre for investigations and checks.

[fxprunayre]

Not a documenter expert, but if we start adding additional notes for each change in each release, readability of the doc in a couple of years will be a challenge, end users will have to read the top text and then applies all the notes with changes in each versions to have the full picture... Readability would be facilitated if the main text represent the current status and additional note highlight changes in past version so end user will have to read the note only if using old stuff? Also consider https://geonetwork-opensource.org/manuals/4.0.x/en/contributing/writing-documentation.html#versionadded-versionchanged-and-deprecated

[fgravin]

I agree.
Breaking changes should be documented somewhere though.

[fxprunayre]

Don't forget to also highlight 4.2.4 new "features" of the ODS harvester geonetwork/core-geonetwork#7059

• produce invalid ISO records
• mix ISO topic categories with free text ODS themes whatever the languages and without icons

[fgravin]

Don't forget to also highlight 4.2.4 new "features" of the ODS harvester geonetwork/core-geonetwork#7059

https://github.com/geonetwork/core-geonetwork/blob/main/CODE_OF_CONDUCT.md#our-standards

Trolling, insulting/derogatory comments, and personal or political attacks

[jodygarnett]

This PR was still open? It missed out on the mkdocs conversion ... can you make this change to core-geonetwork please

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[jodygarnett]

Collected this feedback for geonetwork/core-geonetwork#9161