From 0f6a4e528d738931de08196c38a5c389c09e2b90 Mon Sep 17 00:00:00 2001
From: Dylan Araps <dylan.araps@gmail.com>
Date: Thu, 19 Sep 2019 14:03:35 +0300
Subject: [PATCH] docs: update

---
 README.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d897756..60f74f3 100644
--- a/README.md
+++ b/README.md
@@ -6,8 +6,12 @@
 <h1 align="center">pure sh bible</h1> <p
 align="center">A collection of pure POSIX sh alternatives to external processes.</p><br><br>
 
-**NOTE**: If anything seen here is **not** POSIX `sh`, open an issue. This is a living document that is open to change and improvement.
 
+The goal of this book is to document commonly-known and lesser-known methods of doing various tasks using only built-in POSIX `sh` features. Using the snippets from this bible can help remove unneeded dependencies from scripts and in most cases make them faster. I came across these tips and discovered a few while developing [KISS Linux](https://getkiss.org) and other smaller projects.
+
+The snippets below are all linted using `shellcheck`.
+
+See something incorrectly described, buggy or outright wrong? Open an issue or send a pull request. If the bible is missing something, open an issue and a solution will be found.
 
 # Table of Contents