Show similar functions in docstrings

[ChristianKurz]

I think discoverability would be greatly enhanced, if there would be some hints at similar functions in the docstrings.
I imagine a line of See also: ...function names... which should be generated from a table of related functions automatically.

This came to my mind when looking at the docs of pop!. The functions shift! and splice! offer solutions to similar problems, but their names cannot be guessed from each other.

pop!(collection, key[, default])

  Delete and return the mapping for key if it exists in collection, otherwise return default, or
  throw an error if default is not specified.

[...]

See also: shift!(), splice!()

Of course, the wording is open for bike shedding 👍

[KristofferC]

There is already that in a bunch of places. Feel free to make PR with more of them.

[nalimilan]

That would be great. The manual could also be updated to suggest a standard wording for the section at https://docs.julialang.org/en/stable/manual/documentation/

[Seelengrab]

Is the idea for an automatic generation of the See also part still viable or is the documentation hint added in #23788 sufficient?

Personally, I don't see the added benefit of such a function, since that mapping has to be added manually to a lookup table anyway (in which case adding it to the documentation directly should not be much more effort, no?).