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]

migueldiascosta/pymatgen,Bismarrck/pymatgen,yanikou19/pymatgen,yanikou19/pymatgen,migueldiascosta/pymatgen,ctoher/pymatgen,migueldiascosta/pymatgen,rousseab/pymatgen,ctoher/pymatgen,Bismarrck/pymatgen,Dioptas/pymatgen,Bismarrck/pymatgen,Dioptas/pymatgen,sonium0/pymatgen,ctoher/pymatgen,Bismarrck/pymatgen,yanikou19/pymatgen,sonium0/pymatgen,sonium0/pymatgen,Bismarrck/pymatgen,rousseab/pymatgen,rousseab/pymatgen