fix typo, add caveats
More idiomatic Go