My current plan is I have a language tutorial that pretty much is going to go over everything somebody's going to need to know to read S2 code. It tries to write thing in as basic a level as possible, but there's totally still enough for a programmer to get enough about the language to know what's going on, too. I'll also make a language reference that'll be that kind of a quick know-what-you're-doing scan kind of document.

There's also going to be cookbook sections, that try and give programmers and non-programmers alike enough examples to get their feet wet.

Your plan sounds really great! I look forward to your research and deductions.