I agree, providing context-sensitive example-based documentation would be great, but is also very hard to do without a full-blown parser for every language one supports.