more tweaks to docs; remove diagnostics function