use explicit variable name and improve documentation