further documentation of code