couple of readme and documentation fixes

important: i refactored a bunch of stuff too blame me if i broke
something