added quite a little missing documentation