From 8012e3fe177069a709f30d2ab4a18ff11025c86f Mon Sep 17 00:00:00 2001 From: Taylan Kammer Date: Thu, 8 Jan 2026 14:54:20 +0100 Subject: Draft a Manual front-page. --- docs/index.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 docs/index.md (limited to 'docs/index.md') diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..ca8d814 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,36 @@ +# Zisp Manual + +This document explains the Zisp language and its implementation. + +Zisp intentionally blurs the line between developers and users of the +language. After all, Zisp is software, and its users are software +developers; the easiest way to explain *why* Zisp does certain things +is often to explain *how* it does them. + +That doesn't mean this manual will walk you through the source code +line by line. Instead, consider it a documentation of the code base +at large, doubling as a reference to the language implemented by the +code base. + +## Table of Contents + +1. [Chapter 1: Genesis](c1/) + + This chapter goes through the processes involved in reading source + files and ultimately producing binaries from them. + + 1. [Parse](c1/1-parse.html) + 2. [Decode](c1/2-decode.html) + 3. [Expand](c1/3-expand.html) + 4. [Execute](c1/4-execute.html) + 5. [Compile](c1/5-compile.html) + +2. [Chapter 2: Types](c2/) + + Following is an enumeration of the standard data types, and the + methods Zisp offers for generating new types. + + 1. ... + 2. ... + +3. [Chapter 3: ...] -- cgit v1.2.3