update to keys_core and documentation