document conversions more precisely