Enh : Add deprecated section in Doc #1084
Enh : Doc. Add features comparison in doc. We should UPDATE this.  Fix #1163 related to #1084