Require syntax document

[deafwolf]

As the title, the readme is too simple.

[MarcusE1W]

Have you noticed the examples in anko/_example/scripts/ ? Maybe that helps a bit?

[AlekSi]

Still, language specification would be very useful.

[MichaelS11]

Was curious, what would this look like? Is there an example from another language like Go, JavaScript, Python, etc.?

[AlekSi]

Go language specification is a good example.

[MichaelS11]

Yeah, having language specification would be very nice. I personally would like to see 95%+ code coverage testing first.

[floren]

@MichaelS11 It is hard to write tests without knowing that the expected behavior is. I agree, a language spec is important. I'm writing a description for the documentation of my own project, but in order to do it I'm having to dive into the anko codebase because the examples aren't sufficient. Right now I'm trying to figure out if it's possible to expand / append to a slice, and what precisely is the difference between a slice and an array anyway.

[MichaelS11]

There is a lots still to do, including examples and language specifications. Anyone who would like to help, good PRs are excepted.

Until more examples are made for slices, I would suggest checking out the tests:

https://github.com/mattn/anko/blob/master/vm/vmArraysAndMaps_test.go

[floren]

A BNF syntax would be great, although it's been so long since I've written one that I'm not confident I could pull it off.