Show HN: A Time-Sharing Scheduling Coroutine Script Language
melang.org
melang.org
On the operators page it literally says 'guess' in the example for multiple operators, without ever explaining what the actual operation they perform is. "|" is the worst offender, having read the page I have no idea what it does. The doc assumes you have a terminal available to run the example, but I'm on my phone and cannot just run the code to find out what the operator does (assuming it's clear from the output).
The other pages are not like this. Please clarify what each operator actually does.
With these kinds of docs, it's helpful if you can provide an example of what makes your language cool right out of the gate. It sounds like the main differentiator for Melang is the coroutines, so something like the HTTP example you give in that section would make a good intro. Comment it well, since you haven't introduced the syntax yet, but providing a taste of the coolest things to come is necessary to get someone to read through the rest of the docs.
* looks at "stream processor .. in Rust" title *