chore(docs): documentation scaffold

Summary: Just to put more things in place.

Signed-off-by: Austin Seipp <aseipp@pobox.com>
Change-Id: I2ae9ccfe205959f983f62475bd8f822f

Author: thoughtpolice

README.md

@@ -1,3 +1,28 @@
 # prototype nix package for supabase postgres
 
-Placeholder. Real documentation TBD.
+This repository contains **experimental code** to package PostgreSQL using
+**[Nix]**, and tooling and infrastructure for deploying it.
+
+Don't know Nix? Want to understand some of the thinking here? To learn about Nix
+and some of the design constraints this repository are under, please see the
+[`docs/`](./docs/) directory which should help get you up to speed.
+
+If you want to install Nix and play along quickly, check out the
+[Start Here](./docs/00-START-HERE.md) page.
+
+[Nix]: https://nixos.org
+
+## Quick start
+
+NIH. Will come a little later. Read docs or ask me questions directly in the
+mean time.
+
+## Other notes
+
+- This repository should work "in perpetuity" (assuming Nix doesn't horribly
+  break years down the line), but will probably be migrated elsewhere if it's
+  successful, so don't get too cozy or familiar.
+- Austin uses **[jujutsu]** to develop this repository; but you don't have to
+  (you should try it, though!) The workflow used for this repo is "linear
+  commits, no merges." If you submit PRs, they'll be rebased on top of the
+  existing history to match that. (YMMV but I prefer this style.)

docs/00-START-HERE.md

@@ -0,0 +1,3 @@
+# 00 — Starting Line: installing Nix and playing around
+
+Lorem in aliquip cupidatat cupidatat est mollit...

docs/README.md

@@ -0,0 +1,10 @@
+# Documentation
+
+This contains all the needed documentation to (hopefully) help you explicate and
+understand what Nix is, how to use it wisely, how to play with PostgreSQL, and
+probably other stuff to help educate you.
+
+## Table of Contents
+
+- **[00 — Starting Line](./00-START-HERE.md)** — we'll install Nix and play
+  around with it a little.