Clear and concise description of the problem

Most (if not all) of the functions already have JSDoc, but these are just simple e.g. @param <fieldName> without the descriptive text.
We found some documentation like #160, https://fakerjs.dev/api/datatype and e.g. these schema definitions that were just for generating documentation.

Suggested solution

We would like to write these messages to the JSDoc comments, so that IDEs like VSCode can provide them via tooltips.

Alternative

No response

Additional context

After this is done, we think that we can remove the schema definitions.