知识卡片

普通读书笔记卡 · 1828.c.1

术语表决定元素命名

理解等级:初级

目的:确保利益相关者常用的业务和技术术语被理解并编写成文档;架构师协助定义技术术语。术语来自业务实体模型、企业架构规范、愿景及利益相关者要求(如旅游线路、旅游组织者、顾客、线路预定),通常只记名称和描述;任务会在迭代中多次执行。

为什么与架构师密切相关:架构师必须一致无误地使用术语与利益相关者和团队沟通;术语经常影响需求和方案元素的命名。看似简单,却有如此多的组织失败——导致后续歧义和错误表达,拖延整个项目,而这些问题本可以从一开始避免。

行业标准优先:行业标准中已有的技术术语应直接引用而不是重新定义。

协调同义词和同音异义词:大项目中很容易用不同术语描述同一事物,或用同一术语描述不同事物。要在所有用例中使用最受欢迎的术语(可注明其他名称),因为后期改名会导致很多重复工作。例:“服务”在 SOA 技术语境中指通过接口提供的软件能力,在商业服务管理(BSM)的业务语境中指对支持业务的技术的整合。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《架构实战:软件架构设计的过程》第07章《第7章 定义需求》任务:获取常用词汇(最佳实践:协调同义词和同音异义词)(源文件:extracted/架构实战软件架构设计的过程/_epub-src/OEBPS/text00001.html,来源项目 book-sources) - 结论依据:第7章“任务:获取常用词汇”说明术语表的目的、来源与迭代维护,指出术语影响需求和方案元素命名、许多组织在此失败,主张直接引用行业标准术语,并以“服务”一词的不同含义说明协调同义词和同音异义词的必要性。 - 原始内容:另外,这些术语经常影响需求和方案元素的命名,因此,适当地定义这些术语很重要。