documenting the usage of the functions