Test build for #2049

git-image/README.md

@@ -1,7 +1,30 @@
-# The openSUSE Tumbleweed with Git container image
+# openSUSE Tumbleweed with Git: Git application container
 ![Redistributable](https://img.shields.io/badge/Redistributable-Yes-green)
 
-A micro environment with Git based on the openSUSE Tumbleweed Base Container Image.
+
+## Description
+
+Git is a distributed version control system that tracks
+versions of files. Git is primarily designed for controlling source code in collaborative software development.
+
+
+## Usage
+
+This container provides the openSUSE Project version of Git.
+
+Example of using Git container:
+
+```ShellSession
+$ podman run registry.opensuse.org/opensuse/git:2.47 git help
+```
+
+As Git requires a repository, 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 avoid losing all your changes when exiting the container, use a persistent volume mount on launch.
+
+For more use cases and documentation, refer to the
+[Git SCM documentation](https://git-scm.com/doc).
+
 
 ## Licensing