Test build for #2049

git-image/README.md

@@ -1,8 +1,38 @@
-# The SLE 15 SP6 with Git container image
+# SLE 15 SP6 with Git: Git application container
 [![SLSA](https://img.shields.io/badge/SLSA_(v1.0)-Build_L3-Green)](https://documentation.suse.com/sbp/server-linux/html/SBP-SLSA4/)
 [![Provenance: Available](https://img.shields.io/badge/Provenance-Available-Green)](https://documentation.suse.com/container/all/html/Container-guide/index.html#container-verify)
 
-A micro environment with Git based on the SLE Base Container Image.
+
+## Description
+
+Git is a distributed version control system[ that tracks
+versions of files. It is often used to control source code by programmers who
+are developing software collaboratively.
+
+Design goals of Git include speed, data integrity, and support for
+distributed, non-linear workflows — thousands of parallel branches running on
+different computers.
+
+
+## Usage
+
+This container provides the SUSE LLC version of Git.
+
+Example of using git container:
+
+```ShellSession
+$ podman run registry.suse.com/suse/git:2.43 git help
+```
+
+As Git requires a git repository for most operations to function, the container
+does not explicitly set an entrypoint. This way you can launch the container in
+interactive mode to clone a repository and work on it. To have your changes persisted,
+you need to use a persistent volume mount on launch to avoid losing all your changes
+when exiting the container.
+
+For more use cases and documentation, refer to the
+[Git SCM documentation](https://git-scm.com/doc).
+
 
 ## Licensing