a bit of docu does not hurt