From dab20345f7e0615244b3c78092d24b2a56b30c01 Mon Sep 17 00:00:00 2001
From: GeoNetwork opensource
 <59019313+geonetworkbuild@users.noreply.github.com>
Date: Wed, 19 Jun 2024 12:35:11 +0200
Subject: [PATCH] [Backport 4.2.x] docs: fix image links in
 change-log(version-3.8.0.md and 4.0.0-alpha.1 (#8200)

* docs: fix images in changelog/version-3.8.0.md

* Use Markdowns image syntax instead of the HTML block `figure` to be consistent (and to improve mkdocs mike generation)

* docs: improve images in change-log/version-4.0.0-alpha.1.md

* Use Markdowns image syntax instead of the HTML block `figure` to be consistent (and to improve mkdocs mike generation)

* Apply suggestions from code review

Update figures to follow geonetwork docs writing guidelines (makes use of CSS to be similar to display of html figure)

---------

Co-authored-by: Bernhard E. Reiter <bernhard.reiter+github@intevation.de>
Co-authored-by: Jody Garnett <jody.garnett@gmail.com>
---
 .../docs/overview/change-log/version-3.8.0.md | 22 ++++++++-----------
 .../change-log/version-4.0.0-alpha.1.md       |  6 ++---
 2 files changed, 11 insertions(+), 17 deletions(-)

diff --git a/docs/manual/docs/overview/change-log/version-3.8.0.md b/docs/manual/docs/overview/change-log/version-3.8.0.md
index 128d54844a0..b3920ec8a69 100644
--- a/docs/manual/docs/overview/change-log/version-3.8.0.md
+++ b/docs/manual/docs/overview/change-log/version-3.8.0.md
@@ -4,20 +4,17 @@
 
 -   Search experience
     -   [Saved searches](https://github.com/geonetwork/core-geonetwork/pull/3778)
-
-        <figure>
-        <img src="img/380-usersearches.png" alt="img/380-usersearches.png" />
-        <figcaption>Saved user searches</figcaption>
-        </figure>
+      
+        ![Screenshot where the star left of the search field expands in a dropdown menu with three options](img/380-usersearches.png)
+        *Saved user searches*
 
     -   [Improve PDF output](https://github.com/geonetwork/core-geonetwork/pull/3912)
 
     -   [Add template to display related record as list](https://github.com/geonetwork/core-geonetwork/pull/3908)
 
-        > <figure>
-        > <img src="img/380-related.png" alt="img/380-related.png" />
-        > <figcaption>Add template</figcaption>
-        > </figure>
+        > ![Screenshot showing two related map records below each other](img/380-related.png)
+        > *Add template*
+  
 
     -   [Add support for negative query on any fields](https://github.com/geonetwork/core-geonetwork/pull/3683)
 -   Standards
@@ -33,10 +30,9 @@
 
     -   [Associated resource can now be filtered, sorted](https://github.com/geonetwork/core-geonetwork/pull/3804), add [support for WFS and Atom services](https://github.com/geonetwork/core-geonetwork/pull/3817).
 
-        > <figure>
-        > <img src="img/380-associated.png" alt="img/380-associated.png" />
-        > <figcaption>Filtering associated resources</figcaption>
-        > </figure>
+        > ![Screenshot of Associated resources dialog with filter options](img/380-associated.png)
+        *Filtering associated resources*
+
 -   Harvester
     -   [GeoNetwork / Add paging for better support of large catalogues](https://github.com/geonetwork/core-geonetwork/pull/3916)
     -   [THREDDS / Modernise and simplify harvester](https://github.com/geonetwork/core-geonetwork/pull/3936)
diff --git a/docs/manual/docs/overview/change-log/version-4.0.0-alpha.1.md b/docs/manual/docs/overview/change-log/version-4.0.0-alpha.1.md
index 582ba9add4a..9faa4a509a2 100644
--- a/docs/manual/docs/overview/change-log/version-4.0.0-alpha.1.md
+++ b/docs/manual/docs/overview/change-log/version-4.0.0-alpha.1.md
@@ -86,10 +86,8 @@ This version is a beta version and needs testing and feedback from the community
 -   Transifex / Support multiple branches translation
 -   Multilingual metadata / Records are indexed and displayed but no logic to display depending on user interface language or search on specific language
 
-<figure>
-<img src="img/3990-es-index-multilingual.png" alt="img/3990-es-index-multilingual.png" />
-<figcaption>Multilingual fields are stored as a JSON object with an optional link if using Anchor.</figcaption>
-</figure>
+![Part of a JSON file for string translations](img/3990-es-index-multilingual.png)
+*Multilingual fields are stored as a JSON object with an optional link if using Anchor.*
 
 -   Indexing / Language specific analyzer (draft configuration made for French)
 -   Indexing / Spatial / Support for bounding polygons