formatting
updated docu with possible exceptions
formatting, asserting key name