From 27ebd2033495158882af958bc67b1da3144bc2a7 Mon Sep 17 00:00:00 2001
From: Carl Pearson <cwpears@sandia.gov>
Date: Wed, 10 Jul 2024 08:39:55 -0600
Subject: [PATCH] Update README, only run builds when dockerfiles touched

---
 .github/workflows/ghcr-push.yml |  2 ++
 README.md                       | 13 ++++++++++++-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ghcr-push.yml b/.github/workflows/ghcr-push.yml
index 654b61a..a7cb8c1 100644
--- a/.github/workflows/ghcr-push.yml
+++ b/.github/workflows/ghcr-push.yml
@@ -8,6 +8,8 @@ concurrency:
 on:
   push:
     branches: [ "master" ]
+    paths:
+      - '**/*.dockerfile'
 
 jobs:
   build-16:
diff --git a/README.md b/README.md
index c87b244..c209837 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,15 @@
-# 
+# clang-format
+
+## Quick Run
+
+```bash
+cd your/source/tree
+podman run --rm -v "${PWD}"/src ghcr.io/cwpearson/clang-format-16:latest clang-format ...
+```
+
+Inside the container, the working directory is /src, we use the volume mount to map the host working directory `${PWD}` into `/src`: `-v "${PWD}"/src`.
+
+## Building the Image Locally
 
 ```bash
 podman build -f clang-format-16.dockerfile -t clang-format-16:latest