Improve documentation and add more inline doc examples.

[Renmusxd]

All public structs and functions have docs, but docs can always be improved and examples are worth a thousand words. A comprehensive review to clean up documentation and provide detailed examples makes everyone's life easier.