update SABOK with edits from Will