fix documentation to separate internals better