Added some architectural notes. There will be more of these...