README: brush up API docs
README: brush up API docs

By no means this is the desired result. The library is missing a lot of
documentation about its API but I think it's much better to start documenting
directly in source code, so that https://pkg.go.dev/ can do its magic.

airbrake/gobrake