Feels like these details should be documented in the godoc for the method and not in the README.