From 39ce425a1b113d3e287c68a2c4b738a99a59fcd1 Mon Sep 17 00:00:00 2001
From: konstantinos <boromir674@hotmail.com>
Date: Sun, 18 Aug 2024 16:52:50 +0300
Subject: [PATCH] docs: Changelog update with tooltip and dynamic commands

---
 .../guide_run_gitops_release_me_process.md    | 48 ++++++++++---------
 docs/topics/semantic-release.md               |  5 ++
 2 files changed, 30 insertions(+), 23 deletions(-)

diff --git a/docs/guides/gitops/run/guide_run_gitops_release_me_process.md b/docs/guides/gitops/run/guide_run_gitops_release_me_process.md
index 05ec4e2..5487a6b 100644
--- a/docs/guides/gitops/run/guide_run_gitops_release_me_process.md
+++ b/docs/guides/gitops/run/guide_run_gitops_release_me_process.md
@@ -44,7 +44,7 @@ This is a `how-to` Guide, with everything you need, to "run" the
 ## Guide
 
 
-<div class="annotate" markdown>
+<!-- <div class="annotate" markdown> -->
 
 1. Fire-up `release-me` git tag event
 
@@ -69,19 +69,19 @@ This is a `how-to` Guide, with everything you need, to "run" the
     git pull origin "${release}"
     ```
 
-4. Derive new Sem Ver
+4. Derive Release Semantic Version
 
-    {% include 'diagram-sem-ver-derivation-process.md' %}
+    To help you decide on the Version Bump (`Current_Version + Version_Bump = New_Version`), see the [Decision Diagram](../../../topics/semantic-release.md#semantic-release-version-bump), or read more on the [Semantic Release Topic](../../../topics/semantic-release.md)
 
     Please enter the new **Semantic Release Version**, you intend to publish:
 
 <div class="grid cards" markdown>
 
--   <input type="text" id="semver-input" placeholder="Enter new semver" oninput="updateSemVer()">
+-   <input type="text" id="semver-input" placeholder="Input Release Semantic Version; ie 1.2.1" oninput="updateSemVer()">
 
     ---
 
-    Input new Release Semantic Version
+    Input Release Semantic Version; ie 1.2.1
 
 -   :material-clock-fast:{ .lg .middle } __Automation currently supports__
 
@@ -89,40 +89,42 @@ This is a `how-to` Guide, with everything you need, to "run" the
 
     - `<M.m.p\>` for Public Changes
 
-          Eg: `1.0.0`, `1.2.1`, `0.5.0`
+        Eg: `1.0.0`, `1.2.1`, `0.5.0`
 
     - <M.m.p-dev\d?\> for Private Changes
 
-          Eg: `1.0.1-dev`, `1.2.1-dev2`,  
-          `0.5.0-dev1`
+        Eg: `1.0.1-dev`, `1.2.1-dev2`,  
+        `0.5.0-dev1`
 
 </div>
 
+<div class="annotate" markdown>
 
-5. Update Changelog (1)
-
-6. If you maintain the Sem Ver in your source files, **update Sem Ver in sources**
-
-7. Fire-up a `auto-prod-<sem ver>` git tag event (ie `auto-prod-1.2.0`)
-
-    <pre><code class="language-sh"><span id="semver-output">export _SEM_VER=...</span></code></pre>
+<ol start="5">
+    <li>Update Changelog (1)<pre><code>code CHANGELOG.md</pre></code><pre><code class="language-sh"><span id="semver-output2">git add CHANGELOG.md && commit -m "chore(changelog): add v... Changelog Release Entry"</span></pre></code></li>
+    <li>If you maintain the Sem Ver in your source files, <strong>update Sem Ver in sources (2)</strong></li>
+    <li>Fire-up an <code>auto-prod-&lt;sem ver&gt;</code> git tag event (ie <code>auto-prod-1.2.0</code>)
 
-    <!-- export _SEM_VER=<span id="semver-output">...</span> -->
+        <pre><code class="language-sh"><span id="semver-output">export _SEM_VER=...</span></code></pre>
 
-    ```sh
-    export _tag="auto-prod-${_SEM_VER}"
-    git tag -d "$_tag"; git push --delete origin "$_tag";
-    git tag "$_tag" && git push origin "$_tag"
-    ```
+        ```sh
+        export _tag="auto-prod-${_SEM_VER}"
+        git tag -d "$_tag"; git push --delete origin "$_tag";
+        git tag "$_tag" && git push origin "$_tag"
+        ```
 
-<script> function updateSemVer() { var input = document.getElementById('semver-input').value; document.getElementById('semver-output').innerText = 'export _SEM_VER=' + input; } </script>
+    </li>
+    <li>If, you have setup <code>Human Approval</code>, give the Release a <strong>green light</strong>, by approving a Code Review.</li>
+</ol>
 
-1. If, you have setup `Human Approval`, give the Release a **green light**, by approving a Code Review.
+<script> function updateSemVer() { var input = document.getElementById('semver-input').value; document.getElementById('semver-output').innerText = 'export _SEM_VER=' + input; document.getElementById('semver-output2').innerHTML = 'git add CHANGELOG.md && commit -m "chore(changelog): add v' + input + ' Changelog Release Entry"'; } </script>
 
 </div>
 
 1.  :man_raising_hand: Typically the CHANGELOG.md file!
 
+2.  :man_raising_hand: Typical files are, `VERSION`, `pyproject.toml`, `package.json`, etc.
+
 ## Congratulations :partying_face: !
 
 Your changes should now be merged into `main`.
diff --git a/docs/topics/semantic-release.md b/docs/topics/semantic-release.md
index 7087310..0da2c49 100644
--- a/docs/topics/semantic-release.md
+++ b/docs/topics/semantic-release.md
@@ -27,6 +27,11 @@ quadrantChart
     Add support for new python 3.14: [0.25, 0.64]
 ```
 
+## Semantic Release - Version Bump
+
+{% include 'diagram-sem-ver-derivation-process.md' %}
+
+
 ## Non-Public API Changes
 > Essentially anything that is backwords-compatible.  
 > Any non-breaking changes.