На этом шаге рассмотрим правила моделирования примечаний в UML.
Снабжая модель примечаниями, пользуйтесь следующими правилами:
- добавляйте только те требования, оценки и пояснения, которые вы не можете выразить просто и четко другими средствами UML;
- используйте примечания как своеобразные электронные памятки для отслеживания хода работы;
- не перегружайте модель большими блоками комментариев. Если вам нужны обстоятельные комментарии, используйте примечания, которые указывают на документы, содержащие полный текст пояснений.
При расширении модели стереотипами, помеченными значениями или ограничениями:
- стандартизируйте небольшой набор стереотипов, помеченных значений и ограничений, предназначенных для использования в вашем проекте, и не позволяйте отдельным разработчикам создавать новые расширения;
- задавайте короткие информативные имена стереотипов и помеченных значений;
- если требования точности не слишком строги, используйте для спецификации ограничения текст произвольного формата. В противном случае применяйте OCL для описания ограничений.
При изображении стереотипа, помеченного значения или ограничения:
- используйте графические стереотипы умеренно. Вы можете полностью переопределить базовую нотацию UML посредством стереотипов, но тем самым вы затрудните понимание моделей посторонними пользователями;
- помните о возможности цветового выделения графических стереотипов и сложных пиктограмм. Как правило, простая нотация всегда лучше – решение модели в цвете может облегчить ее понимание.
На следующем шаге рассмотрим таксономию диаграмм UML.
