docs: framework/reference pass 2 (stages, architectures, macros, debugging)

docs: framework/reference pass 2 (stages, architectures, macros, debugging) #30