From 2bcd43d4df141eec52c06ffea99645b96e0af2f4 Mon Sep 17 00:00:00 2001
From: Jason Swank <jswank@sonatype.com>
Date: Thu, 16 Mar 2023 12:51:28 -0400
Subject: [PATCH] more docs

---
 README.md | 24 ++++++++++++++++++------
 1 file changed, 18 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 9223300..fcc8fcc 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,24 @@ $ docker run -ti --rm ghcr.io/jswank/alpine-cli
 ~ $ ^D
 exit
 
+$ bin/cli
+~ $ ^D
+exit
+```
+
+## More Info
+
+The image is based on *alpine:edge*, with a small amount of additional setup/installation done. See 
+the [Dockerfile](Dockerfile) and [ctx/](ctx) for the specifics.
+
+  - Some basic utilities are installed for interative and script-based shell usage
+  - A user is created with sudo (`-u root`) access. 
+  - A few personal preferences are enabled via dotfiles.
+
+A helper script, using [casey/just](https://github.com/casey/just') is in [bin/cli](bin/cli). 
+It can be used to quickly start an ephemeral (or persistent) containers.
+
+```console
 $ bin/cli --list
 Available recipes:
     clean   # remove the persistent image
@@ -18,12 +36,6 @@ Available recipes:
     persist # run (or attach to) a perisent container {{n}}
     run     # run a temporary container based on {{image}}
 
-```
-
-A script, using [casey/just](https://github.com/casey/just') is in [bin/cli](bin/cli). 
-It can be used to quickly start an ephemeral (or persistent) container:
-
-```console
 $ bin/cli
 ~ $ ^D
 exit