Joel,
Just today I was speaking with Roberto on this very problem! This weekend he promised to put together his thoughts on the documentation effort. Vinod and I will be helping him coordinate this.
In fact, I began studying the DocBook docs this afternoon and figured that setting up Jade with emacs or vi might be, like all things software, hell setting up. So I think we would appreciate your help a great deal!
talli