evhub / coconut

Simple, elegant, Pythonic functional programming.
http://coconut-lang.org
Apache License 2.0
4.08k stars 125 forks source link

Add documentation for in-place backward pipes #855

Open aidanmontare-fed opened 5 hours ago

aidanmontare-fed commented 5 hours ago

The in-place backwards pipe operators are a little confusing to me, so I was wondering if other newcomers would benefit from some additional documentation on them.

Counterpoint, perhaps if these are infrequently used, adding detailed information on them would be confusing to newcomers. But the language documentation describes itself as a reference/specification, so I think it makes sense to include them.

aidanmontare-fed commented 5 hours ago

This might just be because I'm new to them, but another potential source of confusion: can you use in-place pipes in a pipeline at all? Would that make sense?