update documentation and update setup docker action

dockerhub-description/README.md

@@ -3,7 +3,29 @@ This action is a wrapper around `dockerhub-description` that installs the requir
 
 The wrapper then invokes the upstream action using the same inputs, making it a drop-in replacement.
 
-usage:
+
+## Inputs
+
+
+This action supports the same inputs as the upstream [`dockerhub-description`](https://github.com/peter-evans/dockerhub-description) action.
+
+
+| Input | Required | Description |
+|---------|----------|-------------|
+| `username` | Yes | Docker Hub username. |
+| `password` | Yes | Docker Hub password or access token. |
+| `repository` | Yes | Docker Hub repository name (`username/repository`). |
+| `short-description` | No | Repository short description. |
+| `readme-filepath` | No | Path to the README file to publish. Defaults to `./README.md`. |
+| `enable-url-completion` | No | Enable automatic URL completion in the README content. |
+
+
+For a complete and up-to-date list of supported inputs, refer to the upstream project documentation:
+
+- [`dockerhub-description`](https://github.com/peter-evans/dockerhub-description)
+
+
+## Usage
 
 ```yaml
 name: Update docker hub description

setup-docker/README.md

@@ -1,10 +1,30 @@
 By default, many Gitea runner environments do not include a Docker installation.<br/>
 This can be problematic because Docker is required by many container-related workflows, including building, tagging, and publishing container images.
 
-This action installs the required dependencies before invoking the underlying action, making it easier to run Docker-based workflows on Gitea runners without duplicating setup steps in every repository.
+This action installs Docker when required and optionally configures Docker Buildx for modern image build workflows. Existing Docker installations are automatically detected and reused.
+This allows container-based workflows to run consistently across Gitea runners without requiring every repository to implement its own Docker setup logic.
 
 
+## Inputs
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `setup-buildx` | Configure Docker Buildx after Docker installation. | `true` |
+
+## Usage
+
+### Install Docker with Buildx (default)
 ```yaml
 - name: Setup docker
   uses: https://git.claeyscloud.com/david/gitea-actions/setup-docker@main
 ``
+
+### Install Docker without Buildx
+
+```yaml
+- name: Setup Docker
+  uses: https://git.claeyscloud.com/david/gitea-actions/setup-docker@main
+  with:
+    setup-buildx: false
+```
+This installs Docker if required but skips Docker Buildx configuration

setup-docker/action.yaml

@@ -4,6 +4,16 @@ description: |
         Install Docker on the runner environment
         This action uses Docker's official convenience installation script at https://get.docker.com/
 
+        By default, Docker Buildx is also configured to provide support for modern Docker build workflows, including multi-platform image builds, advanced caching, and BuildKit features.
+        Existing Docker installations are detected automatically and will not be reinstalled.
+
+inputs:
+  setup-buildx:
+    description: Setup Docker Buildx
+    required: false
+    default: "true"
+
+
 runs:
   using: composite
 
@@ -20,3 +30,7 @@ runs:
             echo "Docker installed:"
             docker --version
         fi
+      
+    - name: Set up Docker Buildx
+      if: inputs.setup-buildx == 'true'
+      uses: docker/setup-buildx-action@v3