further documentation improvements