finalized documenations of new functionality