Documentation needs love

[bagelbits]

This should be done based on the sample data that's in there.

[elliotcubit]

Note: Some of the documentation is inconsistent with the behavior of the API. For example, the ability_bonuses subfield of api/races is type []int in the documentation, but is something resembling NamedAPIResource.

This issue should include fixing the existing documentation reference tables, and verifying the examples match the current response formats. -- Copying the examples may lead to more documentation errors.