better documented operators.py