Нужны критики, диаграмма активности UML (изображение внутри)

Question

Вот мой вопрос Взаимодействие между кодировщиком HTML / Javascript и кодером языка сценариев сервера?

Я решил составить диаграмму деятельности, чтобы описать этот процесс

1. пользователь нажимает кнопку "изменить"
2. preloader показывается пользователю
3. ajax-запрос отправляется по адресу url / ajax_request / category / {category_id} /; мы ожидаем ответа в формате json
4. таймер запущен; если ответ не получен в течение 10 секунд - показать предупреждение «Превышено время ожидания подключения, попробуйте обновить страницу и попробуйте еще раз».
5. ajax-запрос получен в переменную data
6. скрыть прелоадер
7. проверить, если data.success имеет значение false, а затем показать предупреждение "Что-то идет не так".
8. положить data.html в контейнер

Вот моя диаграмма (моя первая диаграмма UML :))

альтернативный текст http://img2.pict.com/a4/77/73/2821248/0/screenshot2b106.png

Как вы думаете, подходит ли это для описания взаимодействия между Javascript и PHP-кодером таким образом?

Любая помощь приветствуется.

PS: Теперь я ищу способ описания данных, переданных на сервер и полученных на сервер. Есть идеи?

Спасибо.

Answer 1

Ваша диаграмма действительно представляет то, что вы пытаетесь передать - последовательность действий, которую должен выполнить программист Java-сценария. Посмотрите на диаграмму, это говорит гораздо больше, чем текст? Как вы думаете, это намного легче читать? Лично я нахожу подобные диаграммы не слишком полезными. Мое предположение было бы просто использовать раскадровку, нарисованную в Vision или PowerPoint или что-то еще.

Вы можете использовать диаграммы состояний для представления потоков экрана, но в современном мире Web 2.0 Ajax все не так ориентировано на экран, поэтому я склонен вместо этого использовать раскадровку.

Я бы использовал диаграммы классов для проектирования важных объектов: службы, которую вы вызываете, и данных, передаваемых в службу и из службы. Если экраны являются сложными, у меня также может быть диаграмма классов для каждого экрана, дающая очень четкое представление о том, какие данные должны быть представлены.