document metadata updates, squashing some regression bugs