diff --git a/docs/resources/registry_image.md b/docs/resources/registry_image.md
index 5e0ad833..f80928c2 100644
--- a/docs/resources/registry_image.md
+++ b/docs/resources/registry_image.md
@@ -8,10 +8,13 @@ description: |-
 <!-- Bug: Type and Name are switched -->
 # docker_registry_image (Resource)
 
-Manages the lifecycle of docker image/tag in a registry.
+Manages the lifecycle of docker image/tag in a registry means it can store one or more version
+of specific docker images and identified by their tags.
 
 ## Example Usage
 
+To be able to update an image itself when an updated image arrives.
+
 ```terraform
 resource "docker_registry_image" "helloworld" {
   name = "helloworld:1.0"