[0.4.0] add inline documentation, fix fringe cases, fix docs

Signed-off-by: Eli Skeggs <eskeggs@globesherpa.com>