tweaks to docs & testing