condensed documentation to short lists