DOC: Change documentation to reflect the new API
DOC: Change documentation to reflect the new API

As it turns out the docstring had an error, it is now solved. The
problem was that the order was not being kept. The generator now
conserves this order.

Achuth17/scikit-bio,xguse/scikit-bio,jdrudolph/scikit-bio,Achuth17/scikit-bio,jensreeder/scikit-bio,SamStudio8/scikit-bio,gregcaporaso/scikit-bio,corburn/scikit-bio,colinbrislawn/scikit-bio,wdwvt1/scikit-bio,averagehat/scikit-bio,kdmurray91/scikit-bio,gregcaporaso/scikit-bio,corburn/scikit-bio,jairideout/scikit-bio,Kleptobismol/scikit-bio,demis001/scikit-bio,johnchase/scikit-bio,xguse/scikit-bio,Kleptobismol/scikit-bio,jensreeder/scikit-bio,anderspitman/scikit-bio,Kleptobismol/scikit-bio,SamStudio8/scikit-bio,kdmurray91/scikit-bio,demis001/scikit-bio,jairideout/scikit-bio,wdwvt1/scikit-bio,johnchase/scikit-bio,anderspitman/scikit-bio,colinbrislawn/scikit-bio,averagehat/scikit-bio,Jorge-C/bipy,jdrudolph/scikit-bio