yet again even more documentation