more documentation for implemented functions