update to keys_core and documentation

This is inconsistent