--- /dev/null
+# VVhitespace #
+
+Welcome to VVhitespace!
+
+VVhitespace is a programming language that descends from Whitespace, making a
+small number of changes with the intention of *taming* the language, providing
+the tools necessary to build non-trivial, whitespace-only applications. As a
+proof of concept, the repository includes an implementation of Hunt the Wumpus
+written in VVhitespace.
+
+Only the characters `[Space]`, `[Tab]`, `[VTab]` and `[LineFeed]` have meaning
+in VVhitespace. All other characters are considered comments. For this reason,
+VVhitespace programs may be embedded in other documents, including in the
+source code of other languages.
+
+The language repository contains several parts:
+
+ - A compiler, `vvc`, accepts human-readable VVhitespace source code and
+ translates it to true VVhitespace code.
+
+ - An interpreter, `vvi`, accepts true VVhitespace files as generated by `vvc`
+ and executes them according to the language rules.
+
+ - A library of useful functions including enhanced stack operations, printf,
+ math operations including random number generation, heap operations, string
+ manipulations and user interactions, and bitwise logic functions.
+
+ - Hunt the Wumpus, a text game in which you explore a randomly connected set
+ of caverns, avoiding deep pits and giant cave bats, all while shooting
+ arrows at a Wumpus that wants to eat a tasty, meaty human like yourself!
+
+ - Examples including code commentary that demonstrate VVhitespace and the
+ stdlib.
+
+ - Tests for both the VVhitespace language and the stdlib. Intended to
+ increase confidence for users that want to tinker with the internals, both
+ test suites come with a README explaining how to run the tests and extend them
+ as necessary.
+
+Obtain VVhitespace at <https://git.subgeniuskitty.com/vvhitespace/.git>.
+
+See `README.md` for more information.
+