ci: auto-generate README

.github/ghadocs/examples/1_environment-variables.md

@@ -0,0 +1,12 @@
+<!-- markdownlint-disable-next-line first-line-heading -->
+### Example Using environment variables
+
+```yaml
+steps:
+  - uses: actions/checkout@v4
+  - uses: hoverkraft-tech/compose-action@v1.5.1
+    with:
+      compose-file: "./docker/docker-compose.yml"
+    env:
+      CUSTOM_VARIABLE: "test"
+```

.github/ghadocs/examples/2_services.md

@@ -0,0 +1,16 @@
+<!-- markdownlint-disable-next-line first-line-heading -->
+### Example using `services`
+
+Perform `docker-compose up` to some given service instead of all of them
+
+```yaml
+steps:
+  # need checkout before using compose-action
+  - uses: actions/checkout@v3
+  - uses: hoverkraft-tech/compose-action@v1.5.1
+    with:
+      compose-file: "./docker/docker-compose.yml"
+      services: |
+        helloworld2
+        helloworld3
+```

.github/ghadocs/examples/3_up-flags.md

@@ -0,0 +1,4 @@
+<!-- markdownlint-disable-next-line first-line-heading -->
+### Example using `up-flags`
+
+Specify flags to pass to the `docker-compose up`. Default is none. Can be used to pass the `--build` flag, for example, if you want persistent volumes to be deleted as well during cleanup. A full list of flags can be found in the [docker-compose up documentation](https://docs.docker.com/compose/reference/up/).

.github/ghadocs/examples/4_down-flags.md

@@ -0,0 +1,4 @@
+<!-- markdownlint-disable-next-line first-line-heading -->
+### Example using `down-flags`
+
+Specify flags to pass to the `docker-compose down` command during cleanup. Default is none. Can be used to pass the `--volumes` flag, for example, if you want persistent volumes to be deleted as well during cleanup. A full list of flags can be found in the [docker-compose down documentation](https://docs.docker.com/compose/reference/down/).

.github/ghadocs/examples/5_compose-flags.md

@@ -0,0 +1,16 @@
+<!-- markdownlint-disable-next-line first-line-heading -->
+### Example using `compose-flags`
+
+Specify flags to pass to the `docker-compose` command. Default is none. A full list of flags can be found in the [docker-compose documentation](https://docs.docker.com/compose/reference/#command-options-overview-and-help).
+
+```yaml
+steps:
+  # need checkout before using compose-action
+  - uses: actions/checkout@v3
+  - uses: hoverkraft-tech/compose-action@v1.5.1
+    with:
+      compose-file: "./docker/docker-compose.yml"
+      services: |
+        helloworld2
+        helloworld3
+```

.github/workflows/main-ci.yml

@@ -11,4 +11,10 @@ concurrency:
 jobs:
   ci:
     uses: ./.github/workflows/__shared-ci.yml
-    secrets: inherit
+    secrets: inherit
+
+  generate-readme:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: bitflight-devops/github-action-readme-generator@v1.8.0

README.md

@@ -1,60 +1,23 @@
-# Docker Compose Action
-
-This action runs your docker-compose file and clean up before action finished.
-
-## Inputs
-
-### `compose-file`
-
-**Optional** The name of the compose file. Default `"./docker-compose.yml"`.
-
-It can be a list of files:
-
-```yml
-compose-file: |
-  docker-compose.yml
-  docker-compose.ci.yml
-```
-
-### `services`
-
-**Optional** Just perform `docker-compose up` to one service instead of all of them
-
-### `up-flags`
-
-**Optional** Used to specify flags to pass to the `docker-compose up`. Default is none. Can be used to pass the `--build` flag, for example, if you want persistent volumes to be deleted as well during cleanup. A full list of flags can be found in the [docker-compose up documentation](https://docs.docker.com/compose/reference/up/).
-
-### `down-flags`
-
-**Optional** Used to specify flags to pass to the `docker-compose down` command during cleanup. Default is none. Can be used to pass the `--volumes` flag, for example, if you want persistent volumes to be deleted as well during cleanup. A full list of flags can be found in the [docker-compose down documentation](https://docs.docker.com/compose/reference/down/).
-
-### `compose-flags`
-
-**Optional** Used to specify flags to pass to the `docker-compose` command. Default is none. A full list of flags can be found in the [docker-compose documentation](https://docs.docker.com/compose/reference/#command-options-overview-and-help).
-
-## Example usage
-
-```yaml
-steps:
-  # need checkout before using compose-action
-  - uses: actions/checkout@v3
-  - uses: hoverkraft-tech/compose-action@v1.5.1
-    with:
-      compose-file: "./docker/docker-compose.yml"
-      down-flags: "--volumes"
-      services: |
-        helloworld2
-        helloworld3
-```
-
-### Using environment variables
-
-```yaml
-steps:
-  - uses: actions/checkout@v3
-  - uses: hoverkraft-tech/compose-action@v1.5.1
-    with:
-      compose-file: "./docker/docker-compose.yml"
-    env:
-      CUSTOM_VARIABLE: "test"
-```
+<!-- markdownlint-disable-next-line first-line-heading -->
+<div align="center" width="100%">
+<!-- start branding -->
+<!-- end branding -->
+<!-- start title -->
+<!-- end title -->
+<!-- start badges -->
+<!-- end badges -->
+---
+
+</div>
+<!-- start description -->
+<!-- end description -->
+<!-- start contents -->
+<!-- end contents -->
+<!-- start usage -->
+<!-- end usage -->
+<!-- start inputs -->
+<!-- end inputs -->
+<!-- start outputs -->
+<!-- end outputs -->
+<!-- start [.github/ghadocs/examples/] -->
+<!-- end [.github/ghadocs/examples/] -->

action.yml

@@ -2,22 +2,22 @@ name: "Docker Compose Action"
 description: "Run your docker-compose file"
 inputs:
   compose-file:
-    description: "relative path to compose file(s)"
+    description: "Relative path to compose file(s). It can be a list of files."
     required: false
     default: "./docker-compose.yml"
-  compose-flags:
-    description: "additional options to pass to `docker-compose` command"
+  services:
+    description: "Services to perform docker-compose up."
+    required: false
+  up-flags:
+    description: "Additional options to pass to `docker-compose up` command."
     required: false
     default: ""
   down-flags:
-    description: "additional options to pass to `docker-compose down` command"
+    description: "Additional options to pass to `docker-compose down` command."
     required: false
     default: ""
-  services:
-    description: "services to perform docker-compose up"
-    required: false
-  up-flags:
-    description: "additional options to pass to `docker-compose up` command"
+  compose-flags:
+    description: "Additional options to pass to `docker-compose` command."
     required: false
     default: ""
 runs: