doc updates
doc tweaks
typos
also need to add a rule for /index
test fix
RC2 release