Context: Software development benefits from having Boundary Artefacts (BAs), as a single artefact can supply stakeholders with different boundaries, facilitating collaboration among social worlds. When those artefacts display inconsistencies, such as incorrect information, the practitioners have decreased trust in the BA. As trust is an essential factor guiding the utilisation of BAs in software projects, it is necessary to understand which principles should be observed when creating them. Objective: This study aimed at develop and validate a preliminary guideline support the creation of trustworthy BAs. Method: We followed a multi-step approach. We developed our guideline through a literature review and previous results from our case study. Second, we submitted the guideline for an expert evaluation via two workshops and a survey. At last, we adjusted our guideline by incorporating the feedback obtained during the workshops. Results: We grouped the principles collected from a literature review into three categories. The first category (Scope) focuses on the scope, displaying principles referring to defining each boundary's target audience, needs, and terminology. The second category (Structure) relates to how the artefact's content is structured to meet stakeholders' needs. The third (Management) refers to principles that can guide the establishment of practices to manage the artefact throughout time. The expert validation revealed that the principles contribute to creating trustworthy BAs at different levels. Also, the relevance of the guideline and its usefulness. Conclusions: The guideline strengthen BA traits such as shared understanding, plasticity and ability to transfer. Practitioners can utilise the guideline to guide the creation or even evaluate current practices for existing BAs.
翻译:语境:软件开发受益于拥有边界工件(BAs),因为单个工件可为利益相关者提供不同的边界,促进不同社会世界间的协作。当这些工件出现不一致(如错误信息)时,实践者对该工件的信任度会降低。由于信任是指导软件项目中边界工件使用的重要因素,因此有必要理解在创建它们时应遵循哪些原则。目标:本研究旨在开发并验证一项初步指南,以支持创建可信的边界工件。方法:我们采用多步骤方法。通过文献综述和先前案例研究的结果,我们初步构建了指南。其次,通过两次研讨会和一次问卷调查,将指南提交给专家进行评估。最后,我们整合研讨会期间获得的反馈,对指南进行了调整。结果:我们将文献综述中收集的原则分为三类。第一类(范围)聚焦于边界范围,体现了定义每个边界的目标受众、需求和术语的原则。第二类(结构)涉及工件内容如何组织以满足利益相关者的需求。第三类(管理)指可指导建立随时间管理工件的实践原则。专家验证表明,这些原则在不同层面上有助于创建可信的边界工件。同时,也验证了指南的相关性及其实用性。结论:该指南强化了边界工件的特性,如共享理解、可塑性和传递能力。实践者可利用此指南来指导创建或评估现有边界工件的当前实践。