a WHOLE bunch of doc improvements