Commit

1 files changed, 63 insertions, 0 deletions

diff --git a/src/node_modules/chance/docs/person/name.md b/src/node_modules/chance/docs/person/name.md
new file mode 100644
index 0000000..46ae9e9
--- /dev/null
+++ b/src/node_modules/chance/docs/person/name.md
@@ -0,0 +1,63 @@
+# name
+
+```js
+// usage
+chance.name()
+chance.name({ middle: true })
+chance.name({ middle_initial: true })
+chance.name({ prefix: true })
+chance.name({ nationality: 'en' })
+```
+
+Generate a random name
+
+```js
+  chance.name();
+  => 'Dafi Vatemi'
+```
+
+Optionally include the middle name
+
+```js
+  chance.name({ middle: true });
+  => 'Nelgatwu Powuku Heup'
+```
+
+
+Optionally include the middle initial
+
+```js
+  chance.name({ middle_initial: true });
+  => 'Ezme I Iza'
+```
+
+Optionally include the prefix
+
+```js
+  chance.name({ prefix: true });
+  => 'Doctor Suosat Am'
+```
+
+Optionally include the suffix
+
+```js
+  chance.name({ suffix: true });
+  => 'Fanny Baker Esq.'
+```
+
+Optionally specify a gender
+
+```js
+  chance.name({ gender: 'male' });
+  => "Patrick Copeland"
+```
+
+Optionally specify a nationality
+
+```js
+  chance.name({ nationality: 'it' });
+  => "Roberta Mazzetti"
+```
+
+Note, currently support for nationality is limited to: `'en', 'it'`.
+