feat: add docstrings to undocumented public types

[joshua-mo-143]

• [x] I have looked for existing issues (including closed) about this

Feature Request

While many of the public types are mostly self explanatory, there are quite a few that either seem to be lacking sufficient documentation or require explanation as to what they are.

We should add documentation to these types.

Motivation

Increase DX and user adoption

[linear[bot]]

RIG-879 feat: add docstrings to undocumented public types

[hghalebi]

I can work on this as well