Aligning documentation with docker-library/official-images#16141 (comment)

Author: FDelporte

azul-zulu/content.md

@@ -5,36 +5,80 @@ Azul Zulu Builds of OpenJDK are fully tested, and TCK compliant builds of OpenJD
 %%LOGO%%
 
 Azul Zulu Builds of OpenJDK are available for free unlimited use and are commercially supported by [Azul](https://www.azul.com/) as a part of the Azul Platform Core bundle.
+
 Check out [Azul Platform Core](https://www.azul.com/products/core/) for more information. The technical documentation can be found on [docs.azul.com/core](https://docs.azul.com/core/).
 
-Docker images of Azul Zulu are available with different base systems: Ubuntu, Debian, CentOS, Alpine, and Distroless.
+## Azul Zulu Images
+
+Azul Zulu images on Docker Hub are available for different combinations of versions, packages, and systems.
+
+### Versions
+
+The following Long Term Support (LTS) versions are available:
+
+* 8
+* 11
+* 17
+* 21
+* 25
+
+Short Term Support (STS) versions are available for six months after their initial release.
+
+### Packages
+
+The following package types are available:
+
+* jdk (default)
+* jdk-headless
+* jre
+* jre-headless
+
+### Systems
+
+Images based on the following base systems are available :  
+
+* Debian (apt)
+* Alpine (apk)
+* Rocky Linux (yum)
 
 ## Usage
 
-To run a container of your choice, use the commands below as an example.
+### Running a Container
 
-* Azul Zulu 17 based on Ubuntu:
-```
-docker run -it --rm azul-zulu:17-ubuntu java -version
-```
-* Azul Zulu 17 based on Debian:
-```
-docker run -it --rm azul-zulu:17-debian java -version
-```
-* Azul Zulu 17 based on CentOS:
+To run a container of your choice and validite its version, use the commands below as an example.
+
+* Azul Zulu based on Debian:
 ```
-docker run -it --rm azul-zulu:17-centos java -version
+docker run -it --rm azul-zulu:<ZULU_VERSION>-debian<DISTRO_VERSION> java -version
 ```
-* Azul Zulu 17 based on Alpine:
+* Azul Zulu based on Alpine:
 ```
-docker run -it --rm azul-zulu:17-alpine java -version
+docker run -it --rm azul-zulu:<ZULU_VERSION>-alpine<DISTRO_VERSION> java -version
 ```
-* Azul Zulu 17 based on Distroless:
+* Azul Zulu based on Rocky Linux:
 ```
-docker run -it --rm azul-zulu:17-distroless java --version
+docker run -it --rm azul-zulu:<ZULU_VERSION>-rockylinux<DISTRO_VERSION> java --version
 ```
 
 As the entrypoint, use:
 ```
-/usr/lib/jvm/zulu17/bin/java
+/usr/lib/jvm/zulu<VERSION>/bin/java
 ```
+
+### Building a Container With Your Own Application
+
+To build a Debian Docker container with a pre-built jar file with, use the following example Dockerfile:
+
+```text
+FROM azul-zulu:<VERSION>
+RUN mkdir /opt/my-app
+COPY my-app.jar /opt/may-app
+CMD ["java", "-jar", "/opt/my-app/my-app.jar"]
+```
+
+You can build and run the Docker Image as shown in the following example:
+
+```bash
+docker build -t my-app-container .
+docker run -it --rm my-app-container
+```