fixed design docs for new roles data structure