From a7cdc7a94ef63b76b4b37bb1a39e5c852f1bb398 Mon Sep 17 00:00:00 2001
From: Alex Eagle <alex@aspect.dev>
Date: Fri, 22 Sep 2023 11:43:54 -0700
Subject: [PATCH] chore(docs): recommend apko

---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index 7fec217b..6ce696bf 100644
--- a/README.md
+++ b/README.md
@@ -62,6 +62,16 @@ rules_oci supports two different registry implementation for the temporary stora
 
 ## Public API Docs
 
+### Build Base images
+
+- Alpine: we recommend <https://github.com/chainguard-dev/rules_apko> to
+  install [apk](https://wiki.alpinelinux.org/wiki/Package_management) packages
+  using Chainguard's [apko](https://apko.dev).
+- Debian: The `apt-get` utility installs `.deb` files, which are already archives
+  that may be used directly as image layers. See `/examples/deb` in this repository.
+  Note that you must enumerate every `.deb` file to install, including transitive dependencies.
+- RHEL/CentOS/Amazon Linux: we don't have any support for this yet. Please consider donating to the project!
+
 ### Construct image layers
 
 - [oci_image](docs/image.md) Build an OCI compatible container image.