improved operator.py documentation