move stuff to ddoc in preparation for wanting message filter
little more progress, and notes for next steps