add docs for typed