document public "api"