organisational upgrades to confirmation docs

diagram and structure shanges