documenting compare.py