Improve documentation for ($) (#22963)
This commit introduces the changes discussed in #22963 (closed). (cc @Kleidukos)
The goal is to improve the documentation of ($)
which was called non-ideal by myself at https://github.com/haskell/core-libraries-committee/issues/132#issuecomment-1426835725, and later in the same thread by others.
Tracking: #17929 @core-libraries