more documentation / comments