docs(parameters): add typedoc api docs

[dreamorosi]

Description of your changes

This PR introduces docstrings for the new Parameters utility which are then converted with typedoc to the API reference published alongside the docs. In line with the other utilities I have documented all public methods more extensively and written long-form intros/reference for each main class & function. The public methods also have example usages which should help users, while the private/protected methods are documented only for the maintainers' sake.

Once merged, this PR will close #1043.

How to verify this change

To help with the review I have published the api docs to this url so that you can see them in your browser.

Note that once the PR is merged the URL will stop working and the docs will be available on the main docs website.

Related issues, RFCs

Issue number: #1043

PR status

Is this ready for review?: YES
Is it a breaking change?: NO

Checklist

• My changes meet the tenets criteria
• I have performed a self-review of my own code
• I have commented my code where necessary, particularly in areas that should be flagged with a TODO, or hard-to-understand areas
• I have made corresponding changes to the documentation
• I have made corresponding changes to the examples
• My changes generate no new warnings
• The code coverage hasn't decreased
• I have added tests that prove my change is effective and works
• New and existing unit tests pass locally and in Github Actions
• Any dependent changes have been merged and published
• The PR title follows the conventional commit semantics

Breaking change checklist

• I have documented the migration process
• I have added, implemented necessary warnings (if it can live side by side)

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[dreamorosi]

Assigning this to you (@am29d) so that you can add commits directly in this PR to address the alpha comments.

Feel free to also fix other things you might encounter. After done, you can either ask for a review or merge it directly.