diff --git a/articles/docker-compose.asm.xml b/articles/docker-compose.asm.xml
index e006c63d9..13c16fb28 100644
--- a/articles/docker-compose.asm.xml
+++ b/articles/docker-compose.asm.xml
@@ -32,10 +32,10 @@
- About docker-compose
+ About &compose;
- About docker-compose
+ About &compose;
@@ -66,8 +66,8 @@
- Managing multi-container applications using <literal>docker-compose</literal>
- Subtitle if necessary
+ Managing multi-container applications using <literal>&compose;</literal>
+
diff --git a/concepts/docker-compose-about.xml b/concepts/docker-compose-about.xml
index b5ad3a7e0..59ab5cab6 100644
--- a/concepts/docker-compose-about.xml
+++ b/concepts/docker-compose-about.xml
@@ -10,7 +10,7 @@
-
- Overview of Compose
+ Overview of &compose;
- The topic describes basics of the Compose tool.
+ The topic describes basics of the &compose; tool.
-
- What is Compose?
+
+ What is &compose;?
- Compose is a tool for managing multi-container applications. Compose enables you to
+ &compose; is a tool for managing multi-container applications. &compose; enables you to
have multiple isolated environment on a single host, recreate only those containers that have
changed and supporit variables between environments.
-
- How does Compose work?
+
+ How does &compose; work?
First, you need to create a YAML file that define your application. In the file, you need to
define the following components:
@@ -72,7 +72,13 @@
You may also need to use a list of environment variables that will be passed to your services.
- After you create the YAML file, you can manage your compose application using the compose CLI.
+ After you create the YAML file, you can manage your application using the &compose; CLI.
+
+
+
+ Where to get &compose;?
+
+ &compose; is present on &productnameshort; by default and can be used out of the box.
diff --git a/concepts/podman-about.xml b/concepts/podman-about.xml
index 90401f8e1..d42064425 100644
--- a/concepts/podman-about.xml
+++ b/concepts/podman-about.xml
@@ -18,7 +18,7 @@
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:trans="http://docbook.org/ns/transclusion">
- Concept
+ About &podman;
diff --git a/references/docker-compose-yaml-file.xml b/references/docker-compose-yaml-file.xml
new file mode 100644
index 000000000..553d63f56
--- /dev/null
+++ b/references/docker-compose-yaml-file.xml
@@ -0,0 +1,77 @@
+
+
+
+
+ %entities;
+]>
+
+
+
+
+
+
+ The <filename>compose.yml</filename> file
+
+
+
+
+ Introductory text
+
+
+
+
+
+ The
+
+ A paragraph of text.
+
+
+ A title
+
+ a-command --with-options
+
+
+ A paragraph of text.
+
+
+
+
+ another-command --with-options
+
+
+ Another paragraph of text.
+
+
+
+
+
+ A table title
+
+
+
+
+
+ an entry
+ another entry
+
+
+ an entry
+ another entry
+
+
+ an entry
+ another entry
+
+
+
+
+
+
diff --git a/tasks/docker-compose-create-application.xml b/tasks/docker-compose-create-application.xml
index e0cbbf7d2..203b042af 100644
--- a/tasks/docker-compose-create-application.xml
+++ b/tasks/docker-compose-create-application.xml
@@ -10,7 +10,7 @@
-
- By using Compose you can create and start a container-based application.
+ By using &compose; you can create and start a container-based application.
-
- Introduction
-
- A paragraph of text.
-
-
-
- Requirements
-
-
-
- An
-
-
-
-
- Unordered
-
-
-
-
- List
-
-
-
-
- A paragraph of text.
-
-
-
- Executing the task
-
- A paragraph of text.
-
-
+
+ The procedure of creating and starting a container-based application can be summarized into the following steps:
+
+
+
- A short introduction to the procedure.
+Prepare the compose.yml file.
-
-
- A step.
-
-
-
-
- A second step.
-
-
-
-
- A third step.
-
-
-
-
-
- Summary
-
- A paragraph of text, summing up the result of the task.
-
-
-
- Troubleshooting
-
- Add some troubleshooting information, if applicable.
-
-
+
+
+
+ Prepare the environment variables file.
+
+
+
+
+ Use &compose; to start the application.
+
+
+
+