more tweaks to docs to test live