I've forked and update the doc at https://github.com/pcmanus/cassandra/commits/3779.
Note that this is a pretty extensive rewrite, but I wanted to make sure it reflected the code and typically rewriting the grammar parts was simpler than checking all the diffs. The doc is also reorganized (and imho improved by it). I've also played with the CSS, but if others don't like it, I'll just keep that CSS for my own use
Going through that also make made remark a few inconsistency here and there in the code. I've noted those down and will open tickets for those, but I've sometimes redacted the doc as if those were fixed. If one of those small fixes/change don't make it, I'll update the doc accordingly. Besides, CQL3 is beta so so is the doc so far.
Please don't hesitate to voice criticism and other complains.