I'll file an issue and by close of Novemeber throw up a straw man for this for our docs