mdsr: add diagram, explain more