[doc] document the issue with doubles