diff -urP mkws/1.0.1/mkws/HOWTO mkws/1.0.2/mkws/HOWTO
--- mkws/1.0.1/mkws/HOWTO Thu Jan 1 02:00:00 1970
+++ mkws/1.0.2/mkws/HOWTO Fri Jul 24 13:42:10 2020
@@ -0,0 +1,88 @@
+# `mkws(1)` HowTos
+
+A collection of **How To**s for building sites with
+[`mkws(1)`](http://mkws.sh/)
+
+## How To Add a Navigation Menu
+In order to add a navigation menu to your website, all you have to do
+is edit the `./share/l.upphtml` file and add your navigation code there.
+Open up `./share/l.upphtml` in your favorite text editor and add the
+following lines right below the `body` tag:
+
+ <header>
+ <nav>
+ <ul>
+ <li><a href=/>Home</a></li>
+ <li><a href=docs.html>Docs</a></li>
+ <li><a href=srcs.html>Sources</a></li>
+ <li><a href=contact.html>Contact</a></li>
+ </ul>
+ </nav>
+ </header>
+
+Edit to match your website.
+
+Then, regenerate your site using the `mkws` command:
+
+ ./bin/mkws https://example.com
+
+## How To Add Custom Titles (or `meta` tags) For Each Page
+
+As you can see, using `./share/l.upphtml` to generate all our pages,
+means we have only one `title` tag for each page, hence all of our
+generated pages will have the same title. If we would prefer specific
+titles for each page, we would have to edit `./share/l.upphtml` like in
+the following example:
+
+ <head>
+
+ #!
+ case "$1" in
+ ./index.upphtml)
+ #!
+ <title>My Website</title>
+ <meta name=description content='Latest news about my website'>
+ #!
+ ;;
+ ./docs.upphtml)
+ #!
+ <title>Documentation</title>
+ <meta name=description content='Documentation for my website'>
+ #!
+ ;;
+ ./srcs.upphtml)
+ #!
+ <title>Sources</title>
+ <meta name=description content='Sources for my website'>
+ #!
+ ;;
+ ./contact.upphtml)
+ #!
+ <title>Contact</title>
+ <meta name=description content='Contact for my website'>
+ #!
+ ;;
+ esac
+ #!
+
+ </head>
+
+## How To Render [Markdown](https://en.wikipedia.org/wiki/Markdown)
+
+Rendering [Markdown](https://en.wikipedia.org/wiki/Markdown) is not at
+hard at all. Our favorite CLI tool for rendering
+[Markdown](https://en.wikipedia.org/wiki/Markdown) is
+[`smu(1)`](https://github.com/Gottox/smu). You'll have to download it
+and install it on your system either via source or your operating
+systems's package manager. In order to use it, just add:
+
+ #!
+ smu <file>
+ #!
+
+to any of your `*.upphtml` files or create a new `*.upphtml` containing
+just the above code.
+
+Future versions of [`mkws(1)`](http://mkws.sh/) may allow rendering
+[Markdown](https://en.wikipedia.org/wiki/Markdown) directly from source,
+without creating an extra `*.upphtml` file.