finally some more documentation