Provide references to other common names

[wilzbach]

So I found this old discussion:

Perhaps until and find should mention takeWhile and dropWhile. It's not entirely uncommon for someone to think that there's no function in Phobos which does what they want simply because none of them have a name that they recognize as doing what they want. It's not an entirely solvable problem, but we can probably find ways to improve the situation.

So here's an attempt to make the docs a little bit nicer (and Google-friendlier) by providing a couple of reference to other common names in other languages or Phobos.

Should we maybe use a category like Other names?

[dukc]

Looks a bit better IMO if you merge these two clauses, mentioning both alternate names in one go. Nothing what would make me reject this trough.

[dukc]

oops, it seems the other clause i'm talking about does not show above. It is just just below what is shown.

[wilzbach]

I recommend setting your GH diff view to "Split":

[dukc]

Slightly misleading, since D also has a drop function. Better alternative would be to mention it's difference to drop(), and perhaps also add (if it has not already) a similar mention to description of drop().

[dukc]

All in all, I like this.

[dukc]

"often called flatten similar to interpose in other languages" instead of "often called flatten or interpose in other languages" :-P. Otherwise, looks better, in both places I commented.

[wilzbach]

I found @nordlow's very reasonable comment at phobos-next:

argmin and argmax are very common math terms. We should add either add a doc ref or aliases for them

and thus added a mention in the docs for argmin / argmax.
Btw is anything blocking this? (this just improves the documentation pages for a couple of popular functions)

[JackStouffer]

looks good minus one issue

[JackStouffer]

A reference to itself?

[wilzbach]

I wanted to reference only ...

[wilzbach]

looks good minus one issue

Fixed & rebased.

[JackStouffer]

Auto-merge toggled on