documentation improvements

cleanup, consolidation, improvement