The documentation for Seq.prependedAll:
/** As with `:++`, returns a new collection containing the elements from the left operand followed by the
* elements from the right operand.
*
* It differs from `:++` in that the right operand determines the type of
* the resulting collection rather than the left one.
* Mnemonic: the COLon is on the side of the new COLlection type.
This is very confusing. :++ is an alias for appendedAll. The alias for prependedAll is ++:.
The first statement seems to imply that x.prependedAll(y) would be x followed by y, but it’s the opposite. Of course, x ++: y is indeed x followed by y, but only because it is y.prependedAll(x).
The second statement is about x ++: y and x :++ y both being x followed by y but the first has its type driven by y and the second by x. This is as much about prependedAll as it is about appendedAll, but it is only discussed in the prependedAll documentation, not appendedAll, and in terms of :++, which is appendedAll!
My inclination would be to replace the first statement with what’s in appendedAll, but reversed:
/** Returns a new $coll containing the elements from the right hand operand followed by the elements from the
* left hand operand. The element type of the $coll is the most specific superclass encompassing
* the element types of the two operands.
to replace the second part with something about x.prependedAll(y) and y.appendedAll(x) being the same sequence, possibly with different types, and to add something about the COLon on the side of the COLlection to both ++: and :++.
I can write a PR along these lines, but I’m posting here first to check whether I’m the only one who finds the current documentation to be a mess.