a bit more documentation for what we currently do