From b4c4919891c740bd781491193b79538ba74b057e Mon Sep 17 00:00:00 2001 From: Mohammad Akhlaghi Date: Wed, 5 Feb 2020 17:39:55 +0100 Subject: Updated principles section The principles section was made more clear. --- reproducible-paper.tex | 25 ++++++++++++------------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/reproducible-paper.tex b/reproducible-paper.tex index d169015..16483a2 100644 --- a/reproducible-paper.tex +++ b/reproducible-paper.tex @@ -468,36 +468,35 @@ \begin{itemize} \item \textbf{Complete/self-contained:} \begin{itemize} - \pause - \item The project's \alert{only dependencies} should be \alert{POSIX} \textcolor{gray}{(discards Conda or Jupyter which need Python)}. - \pause - \item Project's source should be in \alert{plain-text}: a binary format neeeds special software. - \pause - \item Should be \alert{non-interactive} or runnable in batch (user interaction is an incompleteness). + \item \alert{Only dependency} should be \alert{POSIX} tools \textcolor{gray}{(discards Conda or Jupyter which need Python)}. \pause \item Must \alert{not require root} permissions \textcolor{gray}{(discards tools like Docker or Nix/Guix)}. \pause - \item Should \alert{not require internet} connection. + \item Should be \alert{non-interactive} or runnable in batch (user interaction is an incompleteness). \pause - \item \alert{Version control} (e.g., with Git) can track project's history. + \item Should be usable \alert{without internet} connection. \end{itemize} \pause \item \textbf{Modularity:} Parts of the project should be \alert{re-usable} in other projects. \pause - \item \textbf{Minimal complexity:} Occum’s rasor: “Never posit pluralities without necessity”. + \item \textbf{Plain text:} Project's source should be in \alert{plain-text} \textcolor{gray}{(binary formats need special software)} \begin{itemize} - \pause - \item Avoiding the \alert{fashionable} tool of the day (other tools can also do the job). + \item This includes high-level analysis. + \item It is easily publishable (very low volume of $\times100$KB), archivable, and parse-able. + \item \alert{Version control} (e.g., with Git) can track project's history. + \end{itemize} \pause + \item \textbf{Minimal complexity:} Occum’s rasor: “Never posit pluralities without necessity”. + \begin{itemize} + \item Avoiding the \alert{fashionable} tool of the day: tomorrow another tool will take its place! \item Easier \alert{learning curve}, also doesn't create a \alert{generational gap}. - \pause \item Is \alert{compatible} and \alert{extensible}. \end{itemize} \pause \item \textbf{Verifable inputs and outputs:} Inputs and Outputs must be \alert{automatically verified}. \pause - \item \textbf{Free and open source software:} \alert{Free software} is essential: non-free software is not tracable, not configurable, not distributable, dependent on non-free provider. + \item \textbf{Free and open source software:} \alert{Free software} is essential: non-free software is not configurable, not distributable, and dependent on non-free provider (which may discontinue it in N years). \end{itemize} \end{frame} -- cgit v1.2.1