straighten out work specs and notable keys