io mapping: improve documentation