From 1c7b440fc20148675a5091c53d5d89b0ac3acefd Mon Sep 17 00:00:00 2001
From: Mohammad Akhlaghi <mohammad@akhlaghi.org>
Date: Sat, 7 Dec 2019 23:01:06 +0000
Subject: Analysis demo graph using sharp-edged boxes for source files

As Raul pointed out, to avoid confusion for a color-blind audience, or
when its printed in black-and-white, its best to not just base the
source-build distinction in the graph based on color.

With this commit, the source files have sharp edges and the built
files have round edges.
---
 reproducible-paper.tex | 45 +++++++++++++++++++++++----------------------
 1 file changed, 23 insertions(+), 22 deletions(-)

(limited to 'reproducible-paper.tex')

diff --git a/reproducible-paper.tex b/reproducible-paper.tex
index a0a72f0..7776dfd 100644
--- a/reproducible-paper.tex
+++ b/reproducible-paper.tex
@@ -846,27 +846,28 @@
 
 
   %% Make demo.
-  \makedemoslide{img/make-demo-1-empty.pdf}
+  \makedemoslide{img/make-demo-1.pdf}
                 {Makefiles (\texttt{\*.mk}) keep contextually separate parts of the project, all imported into \texttt{top-make.mk}}
-  \makedemoslide{img/make-demo-2-input1.pdf}
+  \makedemoslide{img/make-demo-2.pdf}
                 {First built/output file (downloaded dataset), managed in \texttt{download.mk}.}
-  \makedemoslide{img/make-demo-3-out1a.pdf}
+  \makedemoslide{img/make-demo-3.pdf}
                 {Downloaded file is used to build analysis-1's first output.}
-  \makedemoslide{img/make-demo-4-out3a.pdf}
-                {Second built file is for analysis-3, also depends on
+  \makedemoslide{img/make-demo-4.pdf}
+                {Third built file is for analysis-3, also depends on
                   a value in a configuration file.}
-  \makedemoslide{img/make-demo-5-out2a.pdf}
+  \makedemoslide{img/make-demo-5.pdf}
                 {First input is also used to build another file (using
                   two configuration parameters).}
-  \makedemoslide{img/make-demo-6-out3b.pdf}
+  \makedemoslide{img/make-demo-6.pdf}
                 {\texttt{out-3b.dat} is automatically built after (depends on) \texttt{out-2a.dat}.}
-  \makedemoslide{img/make-demo-7-input2.pdf}
+  \makedemoslide{img/make-demo-7.pdf}
                 {We now need a second input file, which is downloaded.}
-  \makedemoslide{img/make-demo-8-out1b.pdf}
+  \makedemoslide{img/make-demo-8.pdf}
                 {\texttt{out-1b.dat} depends on \texttt{out-1a.dat},
                   \texttt{input2.dat} and \texttt{param-1.conf}.}
-  \makedemoslide{img/make-demo-9-out2b.pdf}
-                {Final hypothetical output file is also built.}
+  \makedemoslide{img/make-demo-9.pdf}
+                {Final hypothetical output file (of the analysis phase) is
+                  also built.}
 
   \begin{frame}{Benefits of using Make for storing data lineage}
     \Large
@@ -977,30 +978,30 @@
     \end{center}
   \end{frame}
 
-  \makedemoslide{img/make-demo-9-out2b.pdf}
-                {Recall that the data lineage was already recorded in Makefiles.}
-  \makedemoslide{img/make-demo-10-texsources.pdf}
+  \makedemoslide{img/make-demo-9.pdf}
+                {Let's start from the end of the analysis phase (same graph as before).}
+  \makedemoslide{img/make-demo-10.pdf}
                 {Makefiles are also used to connect the analysis with with paper.}
-  \makedemoslide{img/make-demo-11-downloadtex.pdf}
+  \makedemoslide{img/make-demo-11.pdf}
                 {Information from the raw inputs is stored in \texttt{download.tex}.}
-  \makedemoslide{img/make-demo-12-analysis1tex.pdf}
+  \makedemoslide{img/make-demo-12.pdf}
                 {Values to report from the first analysis step are kept in
                   \texttt{analysis1.tex}.}
-  \makedemoslide{img/make-demo-13-analysis2tex.pdf}
+  \makedemoslide{img/make-demo-13.pdf}
                 {Values to report from the second analysis step are kept in
                   \texttt{analysis2.tex}.}
-  \makedemoslide{img/make-demo-14-analysis3tex.pdf}
+  \makedemoslide{img/make-demo-14.pdf}
                 {Values to report from the third analysis step are kept in
                   \texttt{analysis3.tex}.}
-  \makedemoslide{img/make-demo-15-initializetex.pdf}
+  \makedemoslide{img/make-demo-15.pdf}
                 {General project information are stored in \texttt{initialize.tex}.}
-  \makedemoslide{img/make-demo-16-projecttex.pdf}
+  \makedemoslide{img/make-demo-16.pdf}
                 {All the \LaTeX{} macros are loaded into the single
                   \texttt{project.tex} (after the analysis is complete).}
-  \makedemoslide{img/make-demo-17-paper.pdf}
+  \makedemoslide{img/make-demo-17.pdf}
                 {With the paper's \LaTeX{} source, \texttt{project.tex} is
                  used to build the final PDF paper.}
-  \makedemoslide{img/make-demo-17-paper.pdf}
+  \makedemoslide{img/make-demo-17.pdf}
                 {Full data lineage (raw input $\leftrightarrow$ every
                   number/paragraph and plot in paper's PDF) is recorded.}
 
-- 
cgit v1.2.1