add documentation about functions used