Documentation Discussion
Source Code Documentation
I'd like for others that attempt to read through the source code of Ion to post in here when they find a section of code that they don't understand, or where documentation is inadequate/wrong, so that we can work to get all the potentially-confusing code properly documented for future generations of Ion users and developers.
Ion Syntax Documentation
Likewise, any users of Ion that find documentation lacking in the readme should report here should we need to write some better documentation, add more examples, explain how some things work and why. That sort of thing.