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及Web版Word)展开详细分析。我们认为,该方法在可扩展性、灵活性以及学术与工业界多数协同写作任务的结构化方面具有显著优势。