This doc should not expose the internal implementation details to the caller. It's fine to just have the first paragraph.