adds doc examples for operators

adds doc examples to overview section
fixes some doc typo's in comparison examples