lark
lark copied to clipboard
lark-parser
Design a new Lark cheatsheet
The existing cheatsheet is here: https://github.com/lark-parser/lark/blob/master/docs/lark_cheatsheet.pdf
The design and format are somewhat lacking.
I would at least like to see the contents of common.lark in the cheat sheet...
I have gone through https://github.com/lark-parser/lark/blob/master/docs/lark_cheatsheet.pdf What are the changes that you are looking for?
Hey @erezsh please checkout the new design of the cheatsheet I made. https://drive.google.com/file/d/1BrmYnhsNe9T8fjWDivB-o9tXmHoAXgBY/view?usp=sharing Please let me know what you think of it.
@SarthakDandriyal What would you say you improved or fixed? Why do you think new users would prefer your version over the old one? (I ask because I fail to see it, but I also know I lack perspective on such matters)
@erezsh in the old version everything is clustered onto a single page which can be confusing for new users . I have put all the information in an organised manner in a number of pages which makes it simpler and easier to read for new readers. If you want me to make some changes please let me know.
Personally I don't think the problem with the cheatsheet is that's on a single page. But I wonder what other users think about it.
Cheatsheet bug: Grammar Definitions says "Terminals only consist of values and other terminals". Values is undefined, and it's not clear what this is trying to say.
The Grammar Reference is much clearer and not much more verbose: "a string, a regular expression, or a concatenation of these." Suggest replacing Rules and Terminals in the cheatsheet with definitions derived from the Grammar Reference. This would make it clear that Terminals cannot use any grammar patterns other than concatenation.
