updated design docs, still in-progress