DOC clarify implementation details