added more documentation of the operations