docs: rewrite README
diff --git a/.gitignore b/.gitignore
@@ -31,3 +31,5 @@ man/neralie.1
# Development tools
.helix/
+*.bkp
+*.log
diff --git a/README.md b/README.md
@@ -1,53 +1,32 @@
-# AIKA
+# aika
-## About
+Converters for Arvelie and Neralie, in C, Python and POSIX shell.
-Aika is a repository dedicated to Arvelie and Neralie utilities, aimed at making these time systems more accessible.
+[Arvelie](https://wiki.xxiivv.com/site/arvelie.html) is a calendar and
+[Neralie](https://wiki.xxiivv.com/site/neralie.html) a decimal clock. Both are by
+[Devine Lu Linvega](https://wiki.xxiivv.com/).
-The repo is split into `c/`, `sh/`, and `py/` directories. I am currently focused on providing C, Python, and POSIX-compliant shell scripts here.
+## Building
-I consider myself a beginner programmer. If you encounter unexpected behavior or have suggestions for optimization, please reach out via email at git@faen.sh.
+ make
+ sudo make install
-## Dependencies
+That installs the binaries, man pages, and shell completions. Building needs `gcc`,
+`make`, and `scdoc`; the Python versions need `python3`, and the shell versions any
+POSIX shell.
-### Build Dependencies
-`gcc` (for C binaries)
+## Layout
-`make` (for build automation)
-
-`scdoc` (for generating man pages)
-
-### Runtime Dependencies
-`python3` (required for Python implementations)
-
-`sh` (any POSIX-compliant shell)
-
-## Installation
-
-### On Arch Linux
-This repo will soon include a `PKGBUILD`, and Arch Linux users can install it as a native package by running `makepkg -si`. It will soon be available in the AUR.
-
-### Manual Installation
-To compile manually and install to `/usr/local`, run `sudo make install`.
-
-This will install the binaries, man pages, and shell completions.
+ c/ C implementations
+ py/ Python implementations
+ sh/ POSIX shell implementations
+ man/ scdoc sources
+ completions/ shell completions
## Usage
-The C and Python utilities support advanced features like live clocks and specific date/time parsing.
-
-`arvelie --help` to display help
-
-`neralie --count` will run a continuous clock
-
-The shell scripts in `sh/` are strictly minimal, providing basic current time/date conversion only.
-
-## Examples
-`arvelie 2021-01-08` will convert 2021-01-08 to Arvelie format
-
-`neralie 14:30` will convert 14:30 to Neralie format
-## Contributions
-Contributions and forks are highly encouraged! My goal is to expand accessibility to these time systems through community collaboration.
+ arvelie [DATE] convert a date (YYYY-MM-DD, YYYYMMDD), or today
+ neralie [TIME] convert a time (HH:MM[:SS]), or now
+ neralie -c run a continuous clock
-## License
-Licensed under the Unlicense. See https://unlicense.org/ for details.
+Each has a man page: `man arvelie`, `man neralie`.