reasonml.github.io icon indicating copy to clipboard operation
reasonml.github.io copied to clipboard

Please document most operators in a single table

Open codekiln opened this issue 5 years ago • 2 comments

One of the more frustrating parts of learning any language is trying to discover the common name for an operator in that language's community so you can then search for it by name. I was trying to link someone to the docs for the |> operator, and it took longer than it should to find it. Google, discord and github search all pretty much choke on trying to search for something like |>. Searching for "Pipe" returns results for fast pipe but not for |>.

Add a table of common operators and their names so users can at least search for "operators". I'm picturing something like arecvlohe's cheat sheet on operators, but with hyperlinks to the canonical documentation, e.g. reverse application pipe operator should link to "Composition Operators" in pervasives.

codekiln avatar Dec 23 '18 13:12 codekiln

@codekiln That would be a good idea, even the document you link to does not contain the -> pipe first operator :)

kevinsimper avatar Jan 14 '19 21:01 kevinsimper

@rickyvetter What do you think about this one? It can be difficult for beginners to found out what certain operators do :)

kevinsimper avatar Jun 01 '19 00:06 kevinsimper