Join GitHub today
GitHub is home to over 50 million developers working together to host and review code, manage projects, and build software together.
Sign upDocument containing the language specification #308
Labels
Comments
cstffx
changed the title
|
I love the idea but I am not sure how much overhead this could potentially add. Do you have a concrete example? Were you thinking something in the direction of GROQ https://sanity-io.github.io/GROQ/ Thanks. |
|
I tried replying over email but it looks like I have some setup issues. Anyways, I was trying to write that it would be cool if we could generate this spec-md from the grammar and rewriter file. https://github.com/imba/imba/blob/master/src/compiler/grammar.imba1 |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Description
Work in a language specification document.
Why
Keeping up with new features and syntax changes is complicated due to lack of documentation. But everything is easier if each feature is documented in a document that contains a formal description of the language. This could also be useful for those who wish to improve or implement pending features that involve the compiler.
It is a reference document for anyone who wishes to write quality documentation.
Is this something you're interested in working on?
Yes