documentation improvements

some basic restructuring