first draft, still needs transactions and orders tweaks
more tweaks to docs