DOC: correct recommendation for minimize
DOC: correct recommendation for minimize

The docstring of minimize is a bit too negative on the Nelder-Mead.
Unlike what this docstring claims, the Nelder-Mead algorithm is very
robust, in the sense that it doesn't break easily. It is less fast than a
gradient-best method. However, those can easily be broken by a vanishing
gradient. This is actually the reason that the recommended routine in
Matlab optimization does not use a gradient-based solver (it actually
uses the Simplex, aka Nelder-Mead). For people who do not understand at
all what they do, and want a black box optimizer, it might be dangerous
to push too much toward gradient-based solver.

I think that the docstring is scipy downplays too much Nelder-Mead, and I
am proposing a small rewording.

See the second exercise on
http://www.scipy-lectures.org/advanced/mathematical_optimization/index.html#synthetic-exercices
for a simple example that breaks gradient-based solvers.

WarrenWeckesser/scipy,bkendzior/scipy,perimosocordiae/scipy,surhudm/scipy,apbard/scipy,argriffing/scipy,pyramania/scipy,rgommers/scipy,behzadnouri/scipy,sriki18/scipy,Stefan-Endres/scipy,pizzathief/scipy,matthewalbani/scipy,maniteja123/scipy,fredrikw/scipy,scipy/scipy,argriffing/scipy,apbard/scipy,chatcannon/scipy,jjhelmus/scipy,jamestwebber/scipy,jjhelmus/scipy,bkendzior/scipy,zerothi/scipy,chatcannon/scipy,mikebenfield/scipy,tylerjereddy/scipy,jamestwebber/scipy,perimosocordiae/scipy,e-q/scipy,anntzer/scipy,andyfaff/scipy,lhilt/scipy,jakevdp/scipy,aarchiba/scipy,Newman101/scipy,mikebenfield/scipy,Newman101/scipy,kalvdans/scipy,nonhermitian/scipy,Stefan-Endres/scipy,sriki18/scipy,vigna/scipy,josephcslater/scipy,endolith/scipy,woodscn/scipy,chatcannon/scipy,vigna/scipy,befelix/scipy,perimosocordiae/scipy,Stefan-Endres/scipy,WarrenWeckesser/scipy,pyramania/scipy,pbrod/scipy,jakevdp/scipy,haudren/scipy,josephcslater/scipy,mdhaber/scipy,Gillu13/scipy,fredrikw/scipy,anielsen001/scipy,larsmans/scipy,perimosocordiae/scipy,ilayn/scipy,fredrikw/scipy,pbrod/scipy,befelix/scipy,matthew-brett/scipy,chatcannon/scipy,aeklant/scipy,apbard/scipy,scipy/scipy,bkendzior/scipy,e-q/scipy,josephcslater/scipy,matthew-brett/scipy,WarrenWeckesser/scipy,rgommers/scipy,WillieMaddox/scipy,haudren/scipy,apbard/scipy,ilayn/scipy,aarchiba/scipy,grlee77/scipy,zerothi/scipy,scipy/scipy,perimosocordiae/scipy,rgommers/scipy,endolith/scipy,mdhaber/scipy,befelix/scipy,aarchiba/scipy,grlee77/scipy,larsmans/scipy,Stefan-Endres/scipy,pyramania/scipy,anntzer/scipy,scipy/scipy,sriki18/scipy,nonhermitian/scipy,mdhaber/scipy,argriffing/scipy,pyramania/scipy,rgommers/scipy,ilayn/scipy,grlee77/scipy,WillieMaddox/scipy,perimosocordiae/scipy,dominicelse/scipy,minhlongdo/scipy,fredrikw/scipy,gdooper/scipy,arokem/scipy,fredrikw/scipy,andyfaff/scipy,Gillu13/scipy,Shaswat27/scipy,gertingold/scipy,argriffing/scipy,andim/scipy,gdooper/scipy,kalvdans/scipy,surhudm/scipy,vigna/scipy,anntzer/scipy,woodscn/scipy,vigna/scipy,haudren/scipy,chatcannon/scipy,ilayn/scipy,endolith/scipy,kalvdans/scipy,maniteja123/scipy,person142/scipy,scipy/scipy,Eric89GXL/scipy,jor-/scipy,nonhermitian/scipy,person142/scipy,behzadnouri/scipy,minhlongdo/scipy,aarchiba/scipy,Shaswat27/scipy,nmayorov/scipy,kleskjr/scipy,niknow/scipy,dominicelse/scipy,woodscn/scipy,niknow/scipy,jakevdp/scipy,Newman101/scipy,ilayn/scipy,mdhaber/scipy,gfyoung/scipy,lhilt/scipy,befelix/scipy,Eric89GXL/scipy,WarrenWeckesser/scipy,Eric89GXL/scipy,arokem/scipy,woodscn/scipy,minhlongdo/scipy,aeklant/scipy,maniteja123/scipy,zerothi/scipy,haudren/scipy,endolith/scipy,Newman101/scipy,anielsen001/scipy,gfyoung/scipy,lhilt/scipy,jakevdp/scipy,pschella/scipy,surhudm/scipy,Eric89GXL/scipy,WarrenWeckesser/scipy,argriffing/scipy,matthew-brett/scipy,andyfaff/scipy,Gillu13/scipy,matthewalbani/scipy,aeklant/scipy,maniteja123/scipy,niknow/scipy,jor-/scipy,Gillu13/scipy,behzadnouri/scipy,nonhermitian/scipy,gfyoung/scipy,behzadnouri/scipy,matthew-brett/scipy,Stefan-Endres/scipy,WillieMaddox/scipy,person142/scipy,kalvdans/scipy,dominicelse/scipy,josephcslater/scipy,zerothi/scipy,jamestwebber/scipy,jjhelmus/scipy,larsmans/scipy,jjhelmus/scipy,jakevdp/scipy,andyfaff/scipy,anntzer/scipy,e-q/scipy,nmayorov/scipy,andim/scipy,sriki18/scipy,WillieMaddox/scipy,Shaswat27/scipy,andim/scipy,gertingold/scipy,mikebenfield/scipy,Shaswat27/scipy,behzadnouri/scipy,ilayn/scipy,e-q/scipy,gertingold/scipy,pschella/scipy,rgommers/scipy,jor-/scipy,person142/scipy,andim/scipy,sriki18/scipy,Eric89GXL/scipy,apbard/scipy,woodscn/scipy,minhlongdo/scipy,aarchiba/scipy,argriffing/scipy,grlee77/scipy,Gillu13/scipy,pschella/scipy,pyramania/scipy,mikebenfield/scipy,matthewalbani/scipy,gdooper/scipy,kalvdans/scipy,kleskjr/scipy,kleskjr/scipy,pbrod/scipy,gfyoung/scipy,chatcannon/scipy,niknow/scipy,arokem/scipy,minhlongdo/scipy,matthewalbani/scipy,anielsen001/scipy,gdooper/scipy,pbrod/scipy,fredrikw/scipy,mdhaber/scipy,pizzathief/scipy,befelix/scipy,lhilt/scipy,maniteja123/scipy,Stefan-Endres/scipy,andyfaff/scipy,behzadnouri/scipy,gdooper/scipy,matthewalbani/scipy,Eric89GXL/scipy,scipy/scipy,tylerjereddy/scipy,mikebenfield/scipy,e-q/scipy,larsmans/scipy,Newman101/scipy,pizzathief/scipy,matthew-brett/scipy,sriki18/scipy,jor-/scipy,lhilt/scipy,mdhaber/scipy,gfyoung/scipy,bkendzior/scipy,maniteja123/scipy,andim/scipy,aeklant/scipy,arokem/scipy,pizzathief/scipy,jamestwebber/scipy,josephcslater/scipy,bkendzior/scipy,kleskjr/scipy,andim/scipy,dominicelse/scipy,dominicelse/scipy,jjhelmus/scipy,larsmans/scipy,endolith/scipy,nonhermitian/scipy,minhlongdo/scipy,haudren/scipy,tylerjereddy/scipy,Shaswat27/scipy,pizzathief/scipy,niknow/scipy,vigna/scipy,surhudm/scipy,WarrenWeckesser/scipy,anielsen001/scipy,kleskjr/scipy,endolith/scipy,arokem/scipy,tylerjereddy/scipy,gertingold/scipy,pbrod/scipy,zerothi/scipy,nmayorov/scipy,WillieMaddox/scipy,anntzer/scipy,pschella/scipy,gertingold/scipy,Shaswat27/scipy,larsmans/scipy,nmayorov/scipy,surhudm/scipy,aeklant/scipy,anielsen001/scipy,anielsen001/scipy,person142/scipy,Newman101/scipy,pbrod/scipy,grlee77/scipy,nmayorov/scipy,jamestwebber/scipy,surhudm/scipy,zerothi/scipy,woodscn/scipy,jor-/scipy,andyfaff/scipy,pschella/scipy,Gillu13/scipy,haudren/scipy,anntzer/scipy,WillieMaddox/scipy,kleskjr/scipy,tylerjereddy/scipy,niknow/scipy