From b4f06e325c206a74b025b5d93ebd0bd962eed6ca Mon Sep 17 00:00:00 2001
From: 0x1eef <0x1eef@protonmail.com>
Date: Sun, 22 Sep 2024 15:50:11 -0300
Subject: [PATCH] Update docs

---
 README.md | 32 +++++++++++++++++++++-----------
 1 file changed, 21 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 0a5dcf6..4d115d2 100644
--- a/README.md
+++ b/README.md
@@ -1,24 +1,34 @@
 ## About
 
-The webskel utility provides skeletons (or "templates") that can give
-you a head start with your next web application or service. The concept
-is inspired by skeleton directories from the UNIX world - where they can
-be the basis for a new user's `${HOME}` directory.
+The `webskel` utility provides skeletons (or "templates") to help you quickly
+start your next web application or service. The concept is inspired by skeleton
+directories in the UNIX world, where they form the basis for creating a new
+user's `${HOME}` directory.
 
 ## Examples
 
-**webskel new**
+### CLI
 
-The following example demonstrates how the "new" command can create a
-"myapp" directory from the skeleton `@webskel/ruby-graphql-webpack-react`:
+#### webskel new
 
-   user@localhost$ webskel new @webskel/ruby-graphql-webpack-react myapp
+The `webskel new` command creates a new application from a specified skeleton.
+For example, the following command will create a "myapp" directory using the
+`@webskel/ruby-graphql-webpack-react` skeleton:
 
-**webskel ls**
+    user@localhost$ webskel new @webskel/ruby-graphql-webpack-react myapp
 
-The "ls" command provides a list of available skeletons:
+#### webskel ls
 
-   user@localhost webskel ls
+The `webskel ls` command lists all available skeletons. These skeletons are
+located in the [share/webskel/](share/webskel) directory, which is typically
+installed relative to `/usr/local`:
+
+	user@localhost webskel ls
+
+## Sources
+
+* [GitHub](https://github.com/webskel/cli#readme)
+* [GitLab](https://gitlab.com/webskel/cli#readme)
 
 ## License