add docs for occurrences