docs: add docs in `global.go`

[miparnisari]

While debugging https://github.com/mailgun/gubernator/issues/208 I did a bunch of renames that made me understand the code more easily.