added various documentation supplements