DOC: fixed some typos and added a notes section to make the document more compact
DOC: fixed some typos and added a notes section to make the document more compact

jyeatman/dipy,mdesco/dipy,matthieudumont/dipy,demianw/dipy,villalonreina/dipy,JohnGriffiths/dipy,sinkpoint/dipy,oesteban/dipy,StongeEtienne/dipy,villalonreina/dipy,FrancoisRheaultUS/dipy,matthieudumont/dipy,nilgoyyou/dipy,Messaoud-Boudjada/dipy,nilgoyyou/dipy,beni55/dipy,sinkpoint/dipy,FrancoisRheaultUS/dipy,StongeEtienne/dipy,JohnGriffiths/dipy,beni55/dipy,rfdougherty/dipy,oesteban/dipy,Messaoud-Boudjada/dipy,rfdougherty/dipy,demianw/dipy,jyeatman/dipy,mdesco/dipy