and from now on should not deviate from that...
just the package API docs so far, narrative will come later