Clean up documentation and remove junk files from install

1 files changed, 26 insertions, 0 deletions

diff --git a/doc/overview.rst b/doc/overview.rst
new file mode 100644
index 00000000..b03615b9
--- /dev/null
+++ b/doc/overview.rst
@@ -0,0 +1,26 @@
+..
+   Copyright 2020-2021 David Robillard <d@drobilla.net>
+   SPDX-License-Identifier: ISC
+
+########
+Overview
+########
+
+.. default-domain:: c
+.. highlight:: c
+
+The API revolves around two main types: the :doc:`api/serd_reader`,
+which reads text and fires callbacks,
+and the :doc:`api/serd_writer`,
+which writes text when driven by corresponding functions.
+Both work in a streaming fashion but still support pretty-printing,
+so the pair can be used to pretty-print, translate,
+or otherwise process arbitrarily large documents very quickly.
+The context of a stream is tracked by the :doc:`api/serd_env`,
+which stores the current base URI and set of namespace prefixes.
+
+The complete API is declared in ``serd.h``:
+
+.. code-block:: c
+
+   #include <serd/serd.h>