FIXME notes on requirements and design, rebase later
Documentation for the public API and CLI
FIXME - rebase this later, design and TODO notes