Docs cleanup

as promised, here are some updated docs