further documentation changes