more documentation - under the hood