Improve function argument documentation

[jamesmbaazam]

This PR:

• closes #145 by mentioning the expected types of all arguments and return values.
• resolves #63 by making the documentation consistent using the sentence case, followed by a full stop, and representing all classes and base types with angle brackets.

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 98.80%. Comparing base (3fe2965) to head (4a7f6ae).

:exclamation: Current head 4a7f6ae differs from pull request most recent head e3c9bfa. Consider uploading reports for the commit e3c9bfa to get more accurate results

Additional details and impacted files

```diff @@ Coverage Diff @@ ## main #236 +/- ## ======================================= Coverage 98.80% 98.80% ======================================= Files 8 8 Lines 587 587 ======================================= Hits 580 580 Misses 7 7 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.