documentation update architecture fixes