feat(number)!: default to high precision float (#1675)

1 files changed, 14 insertions, 5 deletions

diff --git a/docs/guide/upgrading.md b/docs/guide/upgrading.md
index c30ee63b..673ab610 100644
--- a/docs/guide/upgrading.md
+++ b/docs/guide/upgrading.md
@@ -103,11 +103,20 @@ The `faker.address.*` methods will continue to work as an alias in v8 and v9, bu
 The number-related methods previously found in `faker.datatype` have been moved to a new `faker.number` module.
 For the old `faker.datatype.number` method you should replace with `faker.number.int` or `faker.number.float` depending on the precision required.
 
-    faker.datatype.number() //35
-    faker.datatype.int() //35
-
-    faker.datatype.number({precision:0.01}) //35.21
-    faker.datatype.float({precision:0.01}) //35.21
+By default, `faker.number.float` no longer defaults to a precision of 0.01
+
+```js
+// OLD
+faker.datatype.number({ max: 100 }); // 35
+faker.datatype.number({ max: 100, precision: 0.01 }); // 35.21
+faker.datatype.float({ max: 100 }); // 35.21
+faker.datatype.float({ max: 100, precision: 0.001 }); // 35.211
+
+// NEW
+faker.number.int({ max: 100 }); // 35
+faker.number.float({ max: 100 }); // 35.21092065742612
+faker.number.float({ max: 100, precision: 0.01 }); // 35.21
+```
 
 | Old method              | New method                                 |
 | ----------------------- | ------------------------------------------ |