documentator and documentation improvements