some more documentation here and there