[docs] [issue10297] decimal module documentation is misguiding