added further documentation
minimal layout changes