I agree, that seems like pointless editorializing. If you can open a ticket at perl6/doc/issues on github, I'll remove that sentence this evening. (or someone can beat me to it.)
On Thu, Jul 27, 2017 at 2:39 PM, Sean McAfee <eef...@gmail.com> wrote: > While browsing the Perl 6 docs recently, here: > > https://docs.perl6.org/type/List#method_flatmap > > I noticed this paragraph for the first time: > >> It is considered bad practice to use flatmap. Instead of .flatmap( ), >> please use .map( ).flat as it is clear when the .flat is called and is not >> confusing like .flatmap. > > > To quote a certain president's lawyer: Says who? > > Flat-mapping is awesome; I've written code that does it in several different > programming languages, in none of which is it deprecated in this way. Is > there really any reason to avoid it in Perl 6 other than subjective notions > of how confusing it is? > -- Will "Coke" Coleda