chore: audit doc comments for integer conversion methods

[spiral-ladder]

See: #27 (comment)

We should either:

1. audit the doc comments and make sure we do not make inaccurate safety guarantees, or
2. ensure safety ourselves in our DSL