aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--paper.tex2
-rw-r--r--tex/src/appendix-necessity.tex2
-rw-r--r--tex/src/supplement.tex16
3 files changed, 10 insertions, 10 deletions
diff --git a/paper.tex b/paper.tex
index 79503f2..08980b4 100644
--- a/paper.tex
+++ b/paper.tex
@@ -147,7 +147,7 @@ Longevity is defined as the length of time that a project remains \emph{function
Functionality is defined as \emph{human readability} of the source and its \emph{execution possibility} (when necessary).
Many usage contexts of a project do not involve execution: for example, checking the configuration parameter of a single step of the analysis to re-\emph{use} in another project, or checking the version of used software, or the source of the input data.
Extracting these from execution outputs is not always possible.}
-A basic review of the longevity of commonly-used tools is provided here \new{(for a more comprehensive review, please see
+A basic review of the longevity of commonly used tools is provided here \new{(for a more comprehensive review, please see
\ifdefined\separatesupplement
the supplementary appendices%
\else%
diff --git a/tex/src/appendix-necessity.tex b/tex/src/appendix-necessity.tex
index 7124223..7db810c 100644
--- a/tex/src/appendix-necessity.tex
+++ b/tex/src/appendix-necessity.tex
@@ -13,7 +13,7 @@
%% ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
%% FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
%% for more details. See <http://www.gnu.org/licenses/>.
-\section{Necessity for reproducible research\\(not submitted to journal, here for basic review)}
+\section{Necessity for reproducible research\\(not part of journal article; introductory review for non-specialists)}
\label{appendix:necessity}
The increasing volume and complexity of data analysis has been highly productive, giving rise to a new branch of ``Big Data'' in many fields of the sciences and industry.
diff --git a/tex/src/supplement.tex b/tex/src/supplement.tex
index 317907d..a1d29c8 100644
--- a/tex/src/supplement.tex
+++ b/tex/src/supplement.tex
@@ -74,14 +74,14 @@
%% A short appendix describing this file.
\begin{abstract}
- This supplement contains appendices to accompany the body of the published paper on CiSE (pre-print published on \href{https://arxiv.org/abs/\projectarxivid}{\texttt{arXiv:\projectarxivid}} or \href{https://doi.org/10.5281/zenodo.\projectzenodoid}{\texttt{zenodo.\projectzenodoid}}).
- In the paper's main body we discussed criteria for longevity and introduced a proof of concept that implements them called Maneage (\emph{Man}aging data lin\emph{eage}).
- However, due to the journal word-count limit we could not include a thorough literature review to emphasis on all the valuable lessons learnt from previous methods or compare them (and their lower-level tools) in sufficient detail to the criteria or the proof-of-concept presented in this work.
- Appendix \ref{appendix:existingtools} reviews the low-level tools that used by many (reproducible) workflow solutions (including our proof of concept).
- Appendix \ref{appendix:existingsolutions} reviews many solutions that attept(ed) reproducible management of workflows (including solutions that have been abandonded, discontinued, or unavailable any more).
- To highlight the evolving landscape and its effects on longevity, Appendix \ref{appendix:existingsolutions} discusses them in historical order.
- Finally, in Appendix \ref{appendix:software} an automatically generated, and exaustive, list of software used to build this project is included with their versions.
- This supplement was built over project commit \projectversion.
+ This supplement contains appendices to the main body of the published paper on CiSE (pre-print published on \href{https://arxiv.org/abs/\projectarxivid}{\texttt{arXiv:\projectarxivid}} or \href{https://doi.org/10.5281/zenodo.\projectzenodoid}{\texttt{zenodo.\projectzenodoid}}).
+ In the paper's main body we discussed criteria for longevity and introduced a proof of concept that implements them, called Maneage (\emph{Man}aging data lin\emph{eage}).
+ This supplement provides an in-depth literature review of previous methods and compares them and their lower-level tools in detail with our criteria and with the proof of concept presented in this work.
+ Appendix \ref{appendix:existingtools} reviews the low-level tools that are used by many reproducible workflow solutions (including our proof of concept).
+ Appendix \ref{appendix:existingsolutions} reviews many solutions that attempt(ed) reproducible management of workflows (including solutions that have stopped development, or worse, are no longer available online).
+ To highlight the evolving landscape and its effects on longevity, Appendix \ref{appendix:existingsolutions} discusses the solutions in historical order.
+ Finally, in Appendix \ref{appendix:software} an automatically generated, exhaustive list of software used to build this project is included with the software versions indicated.
+ This supplement was built from project commit \projectversion.
\end{abstract}
%% Import the appendices.