Updates Documentation from Strings to Units

[conor-f]

In many places the documentation suggested that the only types a method could take were strings like miles or kilometers when the code actually supported all Units. Updated this in any place I could find using grep to find the files that needed changes, and manually updating the comments.

This is a non-breaking change.

Supercedes #2218 but fixes no open issues.

Please provide the following when creating a PR:

• Meaningful title, including the name of the package being modified.
• Summary of the changes.
• Heads up if this is a breaking change.
• Any issues this resolves.
• Inclusion of your details in the contributors field of package.json - you've earned it! 👏
• Confirmation you've read the steps for preparing a pull request.