docs: add information on image links

Author: bmorelli25

README.asciidoc

@@ -1718,6 +1718,24 @@ Which looks like:
 
 image::resources/readme/example.svg[An example svg]
 
+[[image-links]]
+=== Image links
+
+You can add relative or absoloute links to your images with the following syntax:
+
+[source,asciidoc]
+----
+image:./images/dynamic-config.svg[link=configuration.html#configuration-dynamic]
+----
+
+Using internal link attributes is also supported, but the image must be inside the internal link syntax.
+It's important to add a space on each side of the image tag. Without spaces, the image will not render.
+
+[source,asciidoc]
+----
+<<configuration-dynamic, image:./images/dynamic-config.svg[] >>
+----
+
 [[videos]]
 == Videos