more commentary for the mappings code