Одной из самых важных вещей, которые, по моему мнению, следует включить в описание вашей архитектуры, является обоснование ваших решений.Почему вы решили отделить этот компонент от остальных, например?Или почему вы используете API Facebook.
Вы также должны смотреть на свою аудиторию.Кто будет читать описание архитектуры?Разработчики, бизнес-аналитик, менеджмент?UML - отличный стандарт для общения с разработчиками, но он плохо работает с деловыми людьми.