aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMohammad Akhlaghi <mohammad@akhlaghi.org>2020-02-05 17:39:55 +0100
committerMohammad Akhlaghi <mohammad@akhlaghi.org>2020-02-05 17:39:55 +0100
commitb4c4919891c740bd781491193b79538ba74b057e (patch)
treebea47ccdf9a4640b5765e311b653dd5ba7e100e6
parent6ca69008832b290703a566a97bbe2775b772edfd (diff)
Updated principles section
The principles section was made more clear.
-rw-r--r--reproducible-paper.tex25
1 files 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}