Updated documentation

Author: coordt

docs/assets/bump-my-version-logo.afdesign

@@ -94,7 +94,7 @@
 .card-content-title {
   margin-top: 0;
   font-weight: 400;
-  font-size: 1.5rem;
+  font-size: 1.25rem;
   line-height: 1.334;
   letter-spacing: 0;
   margin-bottom: 0.35em;
@@ -198,3 +198,25 @@
 .card-divider hr {
   margin: 0;
 }
+
+/*************
+ Cards - side icon
+*/
+.card-icon {
+  min-width: 1.2rem;
+  padding: 16px;
+}
+.card-icon .twemoji {
+  --md-icon-size: 3rem;
+
+}
+
+.card-icon p {
+  margin: 0;
+}
+
+.card-container.horizontal {
+  display: flex;
+  flex-direction: row;
+  /*align-items: center;*/
+}

docs/assets/bump-my-version-logo.svg

@@ -5,28 +5,45 @@ title: Bump My Version
 
 # Bump My Version
 
-Bump My Version's purpose is to:
-
-- Work as a part of an automated build system
-- Manage project versioning through the project's development life cycle
-  - Incrementing version numbers
-  - Serializing version numbers
-  - Parsing version numbers
-  - Support SemVer, CalVer, and other versioning schemes
-- Modify project files as part of the project's development life cycle
-- Work with the project's source control system
-  - Committing changes
-  - Tagging releases
-  - Reading version numbers from tags
-
-## Installation
-
-You can download and install the latest version of this software from the Python package index (PyPI) as follows:
-
-```console
-pip install --upgrade bump-my-version
-```
-<!--
+## Bump My Version's purpose is to
+
+::: grid wide-gap
+    ::: card-container horizontal depth-0
+        ::: card-icon
+            :fontawesome-solid-gear:
+        ::: card-content
+            ::: card-content-title
+                Work as a part of an automated build system.
+            Bump My Version works with automation workflows.
+
+    ::: card-container horizontal depth-0
+        ::: card-icon
+            :fontawesome-solid-magnifying-glass:
+        ::: card-content
+            ::: card-content-title
+                Search and replace data in project files
+            Update the version and metadata in your files when you increment your version.
+
+    ::: card-container horizontal depth-0
+        ::: card-icon
+            :fontawesome-solid-sliders:
+        ::: card-content
+            ::: card-content-title
+                Manage your project's versioning
+            - Increment and serialize version numbers
+            - Parsing version numbers
+            - Support SemVer, CalVer, and other versioning schemes
+
+    ::: card-container horizontal depth-0
+        ::: card-icon
+            :fontawesome-solid-code-commit:
+        ::: card-content
+            ::: card-content-title
+                Work with the project's source control system
+            - Committing changes
+            - Tagging releases
+            - Reading version numbers from tags
+
 ## Jump to section
 
 ::: grid wide-gap
@@ -82,4 +99,3 @@ pip install --upgrade bump-my-version
             { .card-content-title }
 
             Want to understand the library better? Read our explanations behind the design.
--->

docs/assets/css/cards.css

@@ -2,10 +2,10 @@
 
 ## Installation
 
-You can download and install the latest version of this software from the Python package index (PyPI) as follows:
+To install Bump My Version as an independent tool, use [uv](https://docs.astral.sh/uv/getting-started/installation/) to install it on your system.
 
 ```console
-pip install --upgrade bump-my-version
+uv tool install bump-my-version
 ```
 
 ## Create a default configuration
@@ -57,6 +57,16 @@ $ bump-my-version show-bump 1.2.3
                ╰─ patch ─ 1.2.4
 ```
 
+## Get the new version in a script
+
+If you want to get the new version within a script, you can use the [`show`](../../reference/cli/#bump-my-version-show) method.
+
+```console title="Extract the new version"
+$ bump-my-version show current_version
+1.2.3
+$ bump-my-version show --increment minor new_version
+1.3.3
+```
 
 ## Configure a file to modify when bumping