Collaborative writing is essential for teams that create documents together. Creating documents in large-scale collaborations is a challenging task that requires an efficient workflow. The design of such a workflow has received comparatively little attention. Conventional solutions such as working on a single Microsoft Word document or a shared online document are still widely used. In this paper, we propose a new workflow consisting of a combination of the lightweight markup language AsciiDoc together with the state-of-the-art version control system Git. The proposed process makes use of well-established workflows in the field of software development that have grown over decades. We present a detailed comparison of the proposed markup + Git workflow to Word and Word for the Web as the most prominent examples for conventional approaches.We argue that the proposed approach provides significant benefits regarding scalability, flexibility, and structuring of most collaborative writing tasks, both in academia and industry.
翻译:协作写作是团队共同创建文档的必备技巧。在大规模团队中创建文档是一项具有挑战性的任务,需要高效的工作流程。但是,这种工作流程的设计却得到较少关注。例如,常见的解决方案是在单个Microsoft Word文档上工作或在共享在线文档上工作,这些解决方案仍然被广泛使用。在本文中,我们提出了一种新的工作流程,其中包括轻量级的标记语言AsciiDoc和最先进的版本控制系统Git的组合。所提出的过程利用了软件开发领域中已经发展了几十年的成熟工作流程。我们对所提议的标记语言+ Git工作流程与Word和Word for Web进行了详细的比较,这是传统方法的最显着的例子。我们认为,该提议方法在学术界和工业界中的大多数协作写作任务中都提供了显着的优势,包括可扩展性,灵活性和结构性。