The most recent post in dw_wiki is where Fey and Fu have been coordinating efforts to update the documentation - maybe that would be a good place to brainstorm how best to address your concerns.

(I hope that doesn't come across as dismissive! I am just crap at documentation and I am happy other people are working on it who are not me.)