I’m coming back to Dhall after a bit of a break and know that some things have changed. Interestingly, this is putting me back in the new user boat, and I’m surprised we don’t do a good job of the 1000ft picture. What I was specifically interested in was the defaulting syntax, but after a few minutes of hunting through dhall-lang.org, I couldn’t find it. In fact I still haven’t found it. We can do better than this!
I don’t have a concrete proposal, but I think we need to make it very obvious what the syntax of Dhall is. As an example, I regularly use this cheat sheet for Alloy: http://blackmesatech.com/2013/07/alloy/slides/cheatsheet.landscape.xhtml. Alloy is probably a smaller language, but this shows me almost everything I need to know.
I think we should produce something like this and make it very easy to reach from the homepage. Linking to an ABNF or formal specification is the wrong level of detail. I’m a human, not a computer!