I wonder if you could try implementing this as another compile step on top of arc (with another REPL layer, etc), and then see whether it becomes more popular to code with or without this.
It would be great if we could have a documentation system that basically formed a tree of use-cases (perhaps inspired by the python documentation, ACL and PCL to start with) and then contained tutorial style guides on using functionality for different outcomes.
Current thinking: a series of html pages that form a tree of headings, with each linking to a blog entries. People could add recommended modifications through the blog comments, and then I could filter that into a tight set of technical documentation, all in the same style.
Reader - if you're enthusiastic for this let me know ideas for variations - I'm finishing a contract today and could start setting something up like this tomorrow. The timing of this release is good for me.