From 1c2061404db9209758f6bb066855decb393ea06d Mon Sep 17 00:00:00 2001 From: Boud Roukema Date: Fri, 1 May 2020 05:25:55 +0200 Subject: Several minor edits to the title + abstract Most are minor English tidying, e.g. * spelling: achieving * archivable - https://en.wiktionary.org/wiki/archivable * `i.e.` does not look good in an abstract; * `when` didn't sound quite right; Comment: we no longer state one of the most interesting aspects of Maneage - producing the draft paper that is submittable for peer review in a way that makes it natural for the authors to achieve automatic consistency between the calculations/analysis and the values in the paper. But this is hard to describe in a compact way without disrupting the overall argument of the abstract, so it's a bit of a pity, but people will learn about it anyway from the body of the article (or from trying out the package!) `Peer-review verification` does not directly state producing a pdf. Related to this absence of talking about reproducing the *paper*, not just the calculations, I suggest dropping `, with snapshot \projectversion` from the abstract initially sent to the journal (they can't stop us updating it afterwards), because without the context of explaining that the paper itself is produced from the package, it's not clear what the snapshot means - a snapshot of the abstract? In the `real` paper, it makes sense, because the reader will have access to the rest of the paper. --- paper.tex | 25 +++++++++++++------------ 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/paper.tex b/paper.tex index 0fb14d9..c70b15b 100644 --- a/paper.tex +++ b/paper.tex @@ -24,7 +24,7 @@ -\title{Acheiving long-term and archive-able reproducibility} +\title{Achieving long-term archivable reproducibility} \author{\large\mpregular \authoraffil{Mohammad Akhlaghi}{1,2,3}, \large\mpregular \authoraffil{Ra\'ul Infante-Sainz}{1,2}, \large\mpregular \authoraffil{Boudewijn F. Roukema}{4,3}, @@ -50,24 +50,25 @@ \thispagestyle{firstpage} \maketitle -%% Abstract +%% Abstract % max 250 words for CiSE {\noindent\mpregular %% CONTEXT Many reproducible workflow solutions have been proposed during recent decades. - Most use the popular high-level technologies when they were created, providing an immediate solution that is not sustainable in the long-term. - However, decades later, scientists lack the resources to re-write their projects, while still being accountable for their results. - This creates generational gaps and due to the obsolete technologies, impedes reproducibility or building upon previous work. + Most use the high-level technologies that were popular when they were created, providing an immediate solution that is not sustainable in the long-term. + However, decades later, scientists lack the resources to rewrite their projects, while still being accountable for their results. + This creates generational gaps, which, together with technological obsolescence, impede reproducibility and building upon previous work. %% AIM - We aim to introduce a set of criteria to address this problem and demonstrate their practicality. + We aim to introduce a set of criteria to address this problem and to demonstrate their practicality. %% METHOD - The criteria are: completeness (i.e., no dependency beyond a POSIX-compatible operating system, no administrator privileges, no network connection and primarily stored in plain-text); modular design; temporal provenance; scalability; and free-and-open-source software. + The criteria are: completeness (no dependency beyond a POSIX-compatible operating system, no administrator privileges, no network connection and storage primarily in plain-text); modular design; temporal provenance; scalability; and free-and-open-source software. %% RESULTS - Their usefulness is tested through an implementation: "Maneage" (managing+lineage). - It is stored in machine-actionable and human-readable plain-text, enabling version-control, cheap archival, automatic parsing to extract data provenance, and peer-reviewable verification. - Furthermore, we show that these criteria are not limited to long-term reproducibility but also the immediate/fast regime. - It has been tested in several research publications including the present one, with snapshot \projectversion. + The criteria's usefulness is tested through an implementation: "Maneage" (managing+lineage). + This is stored in machine-actionable and human-readable plain-text, enabling version-control, cheap archiving, automatic parsing to extract data provenance, and peer-reviewable verification. + Furthermore, we show that these criteria are not limited to long-term reproducibility but also provide immediate, fast short-term reproducibility. + The example implementation has been tested in several research publications including the present one, with snapshot \projectversion. %%CONCLUSION - We conclude that requiring longevity from solutions is realistic, and discuss the benefits of these criteria for scientific progress. + We conclude that requiring longevity from solutions is realistic. + We discuss the benefits of these criteria for scientific progress. \horizontalline -- cgit v1.2.1