使用注解最普通的目的是把观察结果、评论或解释以自由的形式写下来。把这些注释直接放在模型中,模型就成了开发过程中创建的各种制品的公共资料库。甚至可以用注解把需要可视化,显示地表示出怎样与模型的相关部分对应。
对注释建模,要遵循如下策略:
• 把注释文本放入注解内,并把该注解放于它对应的元素附近。可以用依赖关系把注解与对应的元素相连接,从而更明确地表明其关系。
• 要记住,可以根据需要隐藏或显示模型中的元素。这意味着不必到处显示依附到可视元素上的注释,而只是在语境中需要交流这种信息时才显露图中的注释。
• 如果注释冗长或者包含比纯文本更复杂的事物,可考虑把注释放在外部的文档中,并把文档链接或嵌入到依附于模型的相应注解中。
• 随着模型演化,保持那些记录着不能从模型本身中导出的重要决策的注释,其他的都舍弃,除非有历史价值。