add documentation of the existing functions