simplify public header
improve docs