add README.md to each example directory with usage instructions

1 files changed, 28 insertions, 0 deletions

diff --git a/examples/gem/README.md b/examples/gem/README.md
new file mode 100644
index 0000000..c05b844
--- /dev/null
+++ b/examples/gem/README.md
@@ -0,0 +1,28 @@
+# Example: As a Gem
+
+Uses RCM as a Bundler-managed gem inside a Rake project.
+
+## Setup
+
+```sh
+bundle install
+```
+
+## Usage
+
+```sh
+# Dry run — show what would change, make no changes
+bundle exec rake setup -- --dry
+
+# Verbose output
+bundle exec rake setup -- --debug
+
+# Apply configuration
+bundle exec rake setup
+```
+
+## What it does
+
+- Creates `/tmp/example/wg0.conf` from an inline ERB template
+
+The task only runs when the current hostname is `earth`.