staticccheck for Go does _some_ of this kind of thing (documenting improper usage). https://staticcheck.io/docs/checks