Refine README description for Docker Hub

Author: cartheur

README.md

@@ -1,20 +1,28 @@
 # debian-bazel
 
-Debian Bullseye image with Bazel available for building distroless images.
+A Debian + Bazel build container for creating distroless-style images without pulling in extra Google project boilerplate.
 
-## Build locally (Podman)
+Use it in a multistage Dockerfile:
+
+```dockerfile
+FROM docker.io/cartheur/debian-bazel:latest AS build
+```
+
+## Local usage (Podman)
+
+Build:
 
 ```bash
 podman build -t docker.io/cartheur/debian-bazel:latest .
 ```
 
-## Run locally (Podman)
+Run:
 
 ```bash
-podman run --rm docker.io/cartheur/debian-bazel:latest
+podman run --rm docker.io/cartheur/debian-bazel:latest bazel --version
 ```
 
-## Push to Docker Hub (Podman)
+Push:
 
 ```bash
 podman login docker.io
@@ -25,9 +33,13 @@ podman push docker.io/cartheur/debian-bazel:latest
 
 Workflow file: `.github/workflows/publish.yml`
 
-Set these repository secrets in GitHub:
+Required repository secrets:
+
+- `DOCKERHUB_USERNAME` (for example `cartheur`)
+- `DOCKERHUB_TOKEN` (Docker Hub access token with push permissions)
+
+The workflow publishes `docker.io/cartheur/debian-bazel:latest` on every push to `main` and on manual dispatch.
 
-- `DOCKERHUB_USERNAME`: your Docker Hub username (`cartheur`)
-- `DOCKERHUB_TOKEN`: Docker Hub access token (not your password)
+## Note on Docker CLI
 
-The workflow pushes `docker.io/cartheur/debian-bazel:latest` on every push to `main`, and also supports manual run from the Actions tab.
+`docker-ce-cli` is not currently installed in this image. If you want remote daemon control (`docker`, `docker compose`, `docker swarm`) from inside this container, I can add that in a separate variant.