Added doc on why we chose to implement a comparator object instead of comparison_function (So that future people know why the odd choice of implementation). [ci skip]
Added doc on why we chose to implement a comparator object instead of
comparison_function (So that future people know why the odd choice of
implementation). [ci skip]


Former-commit-id: f102d0fbedc9950bd1180a4bc474edaa0d7c7287 [formerly c0248019ed7a2b85c1e484c0bf57c6bcf0eee844]
Former-commit-id: 6f877022241f50e83fbec2cfbb66f57d8ddbc8f6
davidwaroquiers/pymatgen,nisse3000/pymatgen,aykol/pymatgen,montoyjh/pymatgen,richardtran415/pymatgen,mbkumar/pymatgen,matk86/pymatgen,johnson1228/pymatgen,fraricci/pymatgen,blondegeek/pymatgen,setten/pymatgen,Bismarrck/pymatgen,gmatteo/pymatgen,davidwaroquiers/pymatgen,fraricci/pymatgen,gpetretto/pymatgen,blondegeek/pymatgen,dongsenfo/pymatgen,gpetretto/pymatgen,Bismarrck/pymatgen,montoyjh/pymatgen,gVallverdu/pymatgen,ndardenne/pymatgen,gVallverdu/pymatgen,blondegeek/pymatgen,vorwerkc/pymatgen,nisse3000/pymatgen,nisse3000/pymatgen,montoyjh/pymatgen,montoyjh/pymatgen,tschaume/pymatgen,czhengsci/pymatgen,tallakahath/pymatgen,aykol/pymatgen,gpetretto/pymatgen,fraricci/pymatgen,matk86/pymatgen,tschaume/pymatgen,richardtran415/pymatgen,johnson1228/pymatgen,Bismarrck/pymatgen,tallakahath/pymatgen,matk86/pymatgen,czhengsci/pymatgen,aykol/pymatgen,richardtran415/pymatgen,tschaume/pymatgen,mbkumar/pymatgen,davidwaroquiers/pymatgen,xhqu1981/pymatgen,xhqu1981/pymatgen,czhengsci/pymatgen,Bismarrck/pymatgen,mbkumar/pymatgen,ndardenne/pymatgen,czhengsci/pymatgen,johnson1228/pymatgen,vorwerkc/pymatgen,vorwerkc/pymatgen,gmatteo/pymatgen,vorwerkc/pymatgen,richardtran415/pymatgen,dongsenfo/pymatgen,setten/pymatgen,dongsenfo/pymatgen,Bismarrck/pymatgen,johnson1228/pymatgen,davidwaroquiers/pymatgen,setten/pymatgen,matk86/pymatgen,gVallverdu/pymatgen,nisse3000/pymatgen,gpetretto/pymatgen,fraricci/pymatgen,xhqu1981/pymatgen,setten/pymatgen,gVallverdu/pymatgen,tallakahath/pymatgen,mbkumar/pymatgen,tschaume/pymatgen,ndardenne/pymatgen,blondegeek/pymatgen,tschaume/pymatgen,dongsenfo/pymatgen