Clarify public API in documentation