Class usage descriptions

[PhazonicRidley]

It would be helpful for classes to have quick blurbs on the intended use case. Either by describing recommended use case (this is already done to some extent) of which interfaces do what (hal::write(), create(), etc). Or by having a quick code example. An example of what this could look like: https://discordpy.readthedocs.io/en/stable/api.html?highlight=wait_for#discord.Client.wait_for