使用功能规范作为项目交流的工具

数字项目涉及复杂的合作网络,他们在最强时画在许多不同种类的专业知识,他们的参与者分享。与此同时,它可以挑战一起画所有这些不同的贡献的信息,要求,需求和想法在一个地方。我们如何桥技术的差异,文化,和学科知识在这些团队中,并创建共享文档,可以在项目的全生命周期发展有效?

在过去的几个月里,数字奖学金集团一直在尝试适应功能规范,写作风格起源于软件应用程序和系统领域作为项目交流的工具。作为东北大学图书馆的一部分,最雷竞技app最新版raybet雷竞技近LibCon事件(一个部门的同事之间共享的项目和想法),DSG的成员提出了一个小组会议,从不同的角度探讨了这项工作的各个方面。这篇文章利用这些演示给功能的概述,挑战,和可能性功能规范的数字人文应用研究小组。

“功能规范”的风格在其原始上下文包括几种不同类型的地形。作为高级DSG开发人员罗伯·查韦斯和副主任Patrick Murray-John系统描述,它捕获重要上下文信息项目的目的和目标,特性和功能工具的开发(从特定用户及其需求的角度),和演员和实体(如用户、角色和数据)。

功能规格定义流程图

有许多好处收集这种级别的详细信息在项目的初始阶段。在实践的层面上规划,提供具体的信息,进而使得开发设计规范,技术规范,发展计划,和测试来确定当一个项目已经成功地完成了:如果功能规范描述了一个搜索函数,它返回的结果相关性排名,我们知道我们才完成工作。DSG也许同样重要的是,创建一个功能规范培养过程中参与合作项目的成分和提示深思考这个项目是真正为了完成,并帮助项目达成一致之前需要把精力放在建立一个工作版本。它还拉在一起的信息可能有助于其他目的(如编写或宣传)。

的功能规范还坐落在一个更广泛的网络工具。帕特里克Murray-John表明书面文档提供了详细具体的特性(比如搜索,查看地图,或者上传一个新文件),然后被翻译成特定的编程或设计任务存储在项目管理工具,如一个问题跟踪器。功能规范提供了一个路线图,正在取得进展的问题跟踪器提供了一个视图,使的日常协调工作和努力很有必要在一个协作的团队。当给定功能原型并最终完成,功能规格可以再次使用的确认,项目的实际需要,它也能作为一个地方记录未完成的工作,可能的范围可能会给未来项目的发展的阶段,或支持未来的筹款努力。

功能规范,在原来的背景下在软件开发行业,通常发生在一个相当统一的技术团队的技能和知识共享。结果,这个流派的共同实践和熟悉的功能主要集中在它的实际和技术方面:数据库存、用户故事、用例,先决条件,从一步一步操作的逻辑流在一个给定的函数上下文。DSG的实验功能规范都集中在建筑流派在几个不同的方向。首先,正如DSG导演茱莉亚佛兰德斯描述的例子美国印第安语言的数字档案保存和毅力(DAILP)项目,功能更有效地规范可以作为项目团队的不同部分之间的桥梁,如果它包括更深层次的上下文信息:不仅用户故事,而且还详细信息的动机和投资特定的用户群体,进而帮助团队了解项目的数据的形状和为什么。DAILP而言,理解语言学习者的不同需求,切罗基部落内学术研究者和语言专家对各级技术设计和决策是至关重要的。随着DSG的发展模板和指导项目团队在编写功能规格,我们将更加重视这些主题和督促项目使用功能规范作为早期提示对话。DSG也被更充分试验涉及项目团队创建功能规范本身,而不是把它当作一个纯粹的技术流派。DSG副主任阿曼达锈讨论她的工作与项目团队公民权利和恢复性司法项目(CRRJ)开发项目的工作流程的详细资料和研究,这一过程已授权该集团想象功能可能性更具体地说,并加强他们的参与和投资在开发过程中。

作为高级数字图书馆开发人员大卫·克里夫指出对小组的贡献,一个重要的角色的功能规范是将对项目范围清晰和共识,并避免误解或时可能发生的可怕的“范围渐变”功能需求并不是一开始就明确了。与此同时,他和其他人指出,像这样的研究项目从本质上倾向于改变他们探索新的可能性。同样的DSG,作为应用研究小组,总是冒险进入一个陌生的领域,准确时间估计困难。

10-panel设计过程的描述。

之间的功能规格必须小心行事试图销下来太密切或过早,一方面,和离开的东西所以遗漏项目从未做过,。迭代中扮演一个重要的角色:有时候一个项目团队需要看到搜索结果显示在他们的原型可以想象方面的全套和选项将使它真正有用。最有用的,功能规格需要能够建立可实现的临时目标,同时跟踪项目最大的愿景。因此总是生活和发展的文档,和作为一个观众指出在小组讨论中,它需要使进化成为可能。

数字奖学金集团迄今为止开发的三个功能规范草案,草案模板也文档我们新兴实践在这一领域。在新的一年里,有几个地方需要进一步的研究和实验。首先,我们要创建一个完整的模板和更详细的文档的不同部分如何以及何时功能规范是最有用的,随机应变。第二,我们要继续尝试涉及项目团队在创作过程中。第三,我们需要开发有效的手段将特定功能的规范转换成具体的开发任务(通过GitHub跟踪)。最后,我们需要解决版本管理的问题,并创建透明机制允许规范发展不失其纪录片价值或制造混乱。