Better API Documentation

[bbengfort]

Scope of changes

This PR replaces our generic SwaggerUI documentation with RapiDoc for a better user experience reading the documentation. It also updates the documentation to improve readability, ensure correctness for the current version of the API and add examples.

Type of change

• bug fix
• new feature
• documentation
• other (describe)

Acceptance criteria

https://www.awesomescreenshot.com/video/30767710?key=25af4033a72139a827b1c8394cb756fd

Author checklist

• I have manually tested the change and/or added automation in the form of unit tests or integration tests
• I have updated the dependencies list
• I have added new test fixtures as needed to support added tests
• I have added or updated the documentation
• Check this box if a reviewer can merge this pull request after approval (leave it unchecked if you want to do it yourself)

Reviewer(s) checklist

• Any new user-facing content that has been added for this PR has been QA'ed to ensure correct grammar, spelling, and understandability.
• To the best of my ability, I believe that this PR represents a good solution to the specified problem and that it should be merged into the main code base.