From 3ae98839c77ca3818257000aa1703aaea2334d30 Mon Sep 17 00:00:00 2001
From: "R. Tyler Croy" <rtyler@brokenco.de>
Date: Fri, 1 Jan 2021 10:47:07 -0800
Subject: [PATCH] Add some getting started documentation

---
 README.adoc | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/README.adoc b/README.adoc
index af850f5..cf8c782 100644
--- a/README.adoc
+++ b/README.adoc
@@ -12,6 +12,51 @@ Zap borrows ideas from
 link:https://puppet.com/docs/bolt/latest/bolt.html[Puppet Bolt]. but leaves
 some of the Puppet-based legacy from Bolt behind.
 
+== Getting Started
+
+Zap is still very early in its development, but if you would like to give it a
+try you can install it via Rust's `cargo` command: `cargo install zap-cli`.
+
+[source,bash]
+----
+cargo install zap-cli
+mkdir my-zap-project
+cd my-zap-project
+wget https://github.com/rtyler/zap/archive/v0.1.0.tar.gz
+tar -zxvf v0.1.0.tar.gz zap-0.1.0/tasks -C tasks --strip=1
+cat > hello.zplan <<EOF
+task 'tasks/echo.ztask' {
+    msg = 'Show them my medal Kif'
+}
+EOF
+----
+
+You will also need to create an inventory file.
+
+.Example inventory.yml
+[source,yaml]
+----
+groups: []
+targets:
+  - name: alpha
+    uri: 192.168.1.1
+    config:
+      ssh:
+        user: root
+        password: root
+
+config:
+  transport: ssh
+----
+
+Once this has been set up, you can run:
+
+[source,bash]
+----
+zap plan hello.zplan -t alpha --dry-run
+----
+
+
 == Examples
 
 [source]