I'm excited to try this out. Examples on the home page would be excellent, but aside from that I ran into one real issue.
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.
Thank you for your attention and feedback. This is indeed a problem. This document was written hastily and is incomplete. I will take the time later today to improve this and other documentation. Thank you very much again.
Thanks. And yes, Melon is the core library. Besides the implementation of various common components, it also includes the implementation of the Melang interpreter. The Melang repository contains implementations of the interpreter launcher and libraries.
Congrats on getting so far on this! I've started a bunch of languages I've never finished, so I understand (somewhat) how much work it takes!
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.
There are indeed many aspects of the current document that can be improved. I will add them one by one in the future. Thank you very much for your suggestions:-)
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.