minor documentator improvements and fixes