Update architecture docs with state persistence and uncertainty

Add architecture documentation

Add references documentation