Closed agitter closed 5 years ago
The section of the review mentioning Manubot is:
Next to the above mentioned editor-focused solutions, GitHub and GitLab can also be used for collaborative authoring. As a noteworthy example of how textual collaboration in scholarly communication with Git[Hub] works, see the The Journal of Open Source Software (JOSS). Further to that, and similarly building on a distinctly GitHub-based workflow, Manubot warrants a mention here: its developers propose a toolchain approach that allows for writing, tracking and converting Markdown-based text into a variety of output formats via a collection of pre-configured tools such as Pandoc (Himmelstein et al. 2019). And while we have not had a chance to try this out in more detail, it might well be an option for those technically-savvy enough to play around with customizing and tweaking their git workflow. Drawing from our own experiences, the development of the Foundations for Open Scholarship Strategydocument (Tennant et al. 2019) was primarily authored using the in-built collaborative tools originally designed for software development, and written in Markdown. The final ‘product’ was then easy to transform into a dynamic webpage, and also a preprint (see Rule 10 for more on this).
It may not be a bad idea to reference this paper since it contains other pre-existing MOOPs. Also would be good for us to at least mention the "MOOP" terminology.
In general, we should decide whether we want to continue updating the Meta Review. I'm in favor of updating the Meta Review with any works or citations that were available as of June 24, 2019 (the journal publication date). I'm okay with citing this MOOP paper even though it came afterwards, because it is so relevant. However, I think we may want to limit the types of changes we are willing to make to the Meta Review, unless we are ready to take on a long term maintenance burden.
Yes, we should minimize what types of changes we plan to make. I would support targeted changes such as:
It could be too much work to update the manuscript to reflect Manubot's current features as it evolves. Specific changes, like new citation types in Table 2, could be an exception, though I see benefits to letting the manuscript reflect the current snapshot of Manubot.
Ten simple rules for researchers collaborating on Massively Open Online Papers (MOOPs) https://doi.org/10.31222/osf.io/et8ak
This paper is relevant and could be discussed during our next round of revisions..