append should be renamed to prepend

[dubiousdavid]

https://smartprocure.github.io/futil-js/#api-lang-append

Given the order of concatenation is reversed from the order of the arguments, this would be better described as prepend instead of append.

[daedalus28]

I'm not sure that's right - we generally try put the data last with functional APIs since that's what usually varies the most. If the function wasn't curried I'd agree more, but I think from an fp API perspective, you expect it to be (thingToAdd, dataThatGetsAddedTo), just as _.join is (thingToJoinBy, dataToJoin). That would make _.add the actual prepend function, but I'm open to discussion. Thoughts?

[dubiousdavid]

I think _.merge is a good point of reference here. The ordering is consistent across lodash and lodash/fp because a reversed ordering for lodash/fp would be counterintuitive.

[daedalus28]

That makes sense and I'm ok with this, but it's a breaking change and should probably wait for a 2.0 release with a few more changes. Alternatively, we might just want to deprecate F.append(x) in favor of _.add(_, x) which is the same number of characters and doesn't introduce a new method name.

[dubiousdavid]

I'd love to have both append and prepend, as add does not convey the concatenation of strings very well and does not always return a string, which append and prepend should/would. Definitely a breaking change to remedy the current naming so a 2.0 release makes sense.