Document future goals for master

Added documentation to method that need to be reworked to acheive
architectural  goals of master.