wow I can't facepalm any harder, I hadn't seen the architecture docs etc in the top level repo... and they're at the top level.