diff --git a/README.md b/README.md
index 91a2076..e425864 100644
--- a/README.md
+++ b/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
 
diff --git a/_service b/_service
index 69e9c85..4b49702 100644
--- a/_service
+++ b/_service
@@ -1,12 +1,12 @@
 <services>
   <service mode="buildtime" name="kiwi_label_helper"/>
   <service mode="buildtime" name="kiwi_metainfo_helper"/>
-  <service name="replace_using_package_version" mode="buildtime">
+  <service mode="buildtime" name="replace_using_package_version">
     <param name="file">git-image.kiwi</param>
     <param name="regex">%%git_version%%</param>
     <param name="package">git-core</param>
   </service>
-  <service name="replace_using_package_version" mode="buildtime">
+  <service mode="buildtime" name="replace_using_package_version">
     <param name="file">git-image.kiwi</param>
     <param name="regex">%%git_major_version%%</param>
     <param name="package">git-core</param>
diff --git a/git-image.changes b/git-image.changes
index 25521ca..36884aa 100644
--- a/git-image.changes
+++ b/git-image.changes
@@ -1,3 +1,13 @@
+-------------------------------------------------------------------
+Tue Dec  3 13:26:37 UTC 2024 - SUSE Update Bot <bci-internal@suse.de>
+
+- Change attribute order in _service
+
+-------------------------------------------------------------------
+Thu Nov 28 14:48:16 UTC 2024 - SUSE Update Bot <bci-internal@suse.de>
+
+- add/extend README
+
 -------------------------------------------------------------------
 Wed Oct 30 15:34:45 UTC 2024 - SUSE Update Bot <bci-internal@suse.de>