added further documentation to some methods