Я обнаружил, что "нормальные" диаграммы последовательности почти всегда более трудны, чем они стоят (хотя я нашел их полезными для отображения потока данных в LINQ). Выполнение «грубой и готовой» схемы и объяснение ее (желательно лично, но с большим количеством слов в любом случае) работает лучше в моем опыте.
Я думаю, что было бы неплохо иметь диаграмму (или несколько), показывающую своего рода «вертикальный срез» вашего приложения - как каждый слой общается с другим, и, возможно, показывающий ход запроса / ответа в подходящих случаях. Однако это не обязательно должно быть на уровне «вызова отдельных методов и всегда на 100% точным» - важно убедиться, что вы передаете правильное общее впечатление, более важно, если читатель сможет погрузиться в реальный код.
Сказав все это, мои взгляды на UML в целом почти одинаковы, поэтому, если вы большой поклонник точных диаграмм, которые всегда тщательно синхронизируются с реальностью и т. Д., То воспринимайте все это как соль: )