doc: update docker docs assuming blank slate

Author: Paul Belt

README.md

@@ -64,27 +64,37 @@ Follow linked crate name for detailed status. Please note that all crates follow
 
 ### Pipeline Integration
 
-Some CI/CD pipelines leverage repository cloning. Below is a copy-paste-able example to build docker images for such workflows.
+Some CI/CD pipelines leverage repository cloning. Below is a copy-paste-able example to build docker images for such workflows. As no official image exists (at this time), one must first be built.
 
-#### Pipeline Integration (recommended)
+#### Pipeline Integration - building the base image (when speed matters)
 
-Build an image without a target and then copy the binaries into your local image
-
-```dockerfile
-COPY --from gitoxide:latest /bin/gix /usr/local/bin/
-COPY --from gitoxide:latest /bin/ein /usr/local/bin/
+```sh
+docker build -f etc/docker/Dockerfile.alpine -t gitoxide:latest --compress . --target=pipeline
 ```
 
-#### Pipeline Integration (base image)
+#### Pipeline Integration - building a smaller base image (when bits on the wire matter)
 
 ```sh
-docker build -f etc/docker/Dockerfile.alpine -t gitoxide:latest --compress . --target=pipeline
+docker build -f etc/docker/Dockerfile.bookworm -t gitoxide:latest --compress . --target=pipeline
 ```
 
-Debian distributions can use:
+Once a docker image is built there are 2 options. One can replace `FROM alpine:latest` (or `FROM debian:bookworm-slim`) with `FROM gitoxide:latest`, or the resulting binaries can be copied into an existing `Dockerfile` and leveraged as a drop-in replacement for `git clone` directives.
+
+#### Pipeline Integration - minimal
+
+For example, if a `Dockerfile` currently uses something like `RUN git clone https://github.com/Byron/gitoxide`, first build the minimal image:
 
 ```sh
-docker build -f etc/docker/Dockerfile.bookworm -t gitoxide:latest --compress . --target=pipeline
+docker build -f etc/docker/Dockerfile.alpine -t gitoxide:latest --compress .
+```
+
+Then copy the binaries into your image and replace the `git` directive with a `gix` equivalent.
+
+```dockerfile
+COPY --from gitoxide:latest /bin/gix /usr/local/bin/
+COPY --from gitoxide:latest /bin/ein /usr/local/bin/
+
+RUN /usr/local/bin/gix clone --depth 1 https://github.com/Byron/gitoxide gitoxide
 ```
 
 ### Production Grade