From 9b5a3ce06dc7957355f7eaedc3b167e800fb24f6 Mon Sep 17 00:00:00 2001
From: Mohammad Akhlaghi <mohammad@akhlaghi.org>
Date: Mon, 25 Nov 2019 01:38:00 +0000
Subject: Added highted text to show relation between files

Some arrows and text were added over the shown Makefile to better help
the eye when the viewers aren't familiar with Make.
---
 reproducible-paper.tex | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)

(limited to 'reproducible-paper.tex')

diff --git a/reproducible-paper.tex b/reproducible-paper.tex
index 1e33af3..9543f6e 100644
--- a/reproducible-paper.tex
+++ b/reproducible-paper.tex
@@ -812,6 +812,72 @@
       \includegraphics[width=\linewidth]{img/reproducible-makefile.png}
     \end{columns}
   \end{frame}
+  \begin{frame}{Reproducible science: Template is managed through a Makefile}
+    \small
+    \begin{columns}
+      \column{10cm}
+
+      All steps (downloading and analysis) are managed by Makefiles\\
+      (example from
+      \textcolor{blue}{\small\href{https://doi.org/10.5281/zenodo.1164774}{zenodo.1164774}}):
+
+      \vspace{5mm}
+      \begin{itemize}
+        \setlength\itemsep{0.7cm}
+      \item Unlike a script which always starts from the top, a
+        Makefile \alert{starts from the end} and steps that don't
+        change will be left untouched (not remade).
+      \item A single \emph{rule} can \alert{manage any number of
+        files}.
+      \item Make can identify independent steps internally and do them
+        in \alert{parallel}.
+      \item Make was \alert{designed for complex projects} with
+        thousands of files (all major Unix-like components), so it is
+        highly evolved and efficient.
+      \item Make is a very \alert{simple} and \alert{small} language,
+        thus easy to learn with great and free documentation (for
+        example
+        \textcolor{blue}{\href{https://www.gnu.org/software/make/manual/}{GNU
+            Make's manual}}).
+      \end{itemize}
+
+      \column{5cm}
+      \includegraphics[width=\linewidth]{img/reproducible-makefile-highlighted-1.png}
+    \end{columns}
+  \end{frame}
+  \begin{frame}{Reproducible science: Template is managed through a Makefile}
+    \small
+    \begin{columns}
+      \column{10cm}
+
+      All steps (downloading and analysis) are managed by Makefiles\\
+      (example from
+      \textcolor{blue}{\small\href{https://doi.org/10.5281/zenodo.1164774}{zenodo.1164774}}):
+
+      \vspace{5mm}
+      \begin{itemize}
+        \setlength\itemsep{0.7cm}
+      \item Unlike a script which always starts from the top, a
+        Makefile \alert{starts from the end} and steps that don't
+        change will be left untouched (not remade).
+      \item A single \emph{rule} can \alert{manage any number of
+        files}.
+      \item Make can identify independent steps internally and do them
+        in \alert{parallel}.
+      \item Make was \alert{designed for complex projects} with
+        thousands of files (all major Unix-like components), so it is
+        highly evolved and efficient.
+      \item Make is a very \alert{simple} and \alert{small} language,
+        thus easy to learn with great and free documentation (for
+        example
+        \textcolor{blue}{\href{https://www.gnu.org/software/make/manual/}{GNU
+            Make's manual}}).
+      \end{itemize}
+
+      \column{5cm}
+      \includegraphics[width=\linewidth]{img/reproducible-makefile-highlighted-2.png}
+    \end{columns}
+  \end{frame}
 
 
 
-- 
cgit v1.2.1

