From 3dded8a9df354e9ed1a90d3bcc13bc71ded19df6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Motiejus=20Jak=C5=A1tys?= <motiejus@jakstys.lt>
Date: Wed, 19 May 2021 22:57:50 +0300
Subject: [PATCH] reproducibility

---
 mj-msc.tex | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/mj-msc.tex b/mj-msc.tex
index a23de9d..4cf329e 100644
--- a/mj-msc.tex
+++ b/mj-msc.tex
@@ -796,7 +796,9 @@ already-working code.
 \subsection{Reproducibility}
 \label{sec:reproducing-the-paper}
 
-% TODO: andriub: Turi būti aiškiai nurodytos instrukcijos, kaip atkartoti veiksmus. Tam gali įdėti trumpą tekstą, kad rezultatais pasidalinta github, projekto pasileidimui reikalavimai nurodyti programinio kodo readme apraše.
+% TODO done: andriub: Turi būti aiškiai nurodytos instrukcijos, kaip atkartoti
+% veiksmus. Tam gali įdėti trumpą tekstą, kad rezultatais pasidalinta github,
+% projekto pasileidimui reikalavimai nurodyti programinio kodo readme apraše.
 
 It is widely believed that the ability to reproduce the results of a published
 study is important to the scientific community. In practice, however, it is
@@ -810,6 +812,9 @@ of it, all the illustrations in this paper are generated using that algorithm,
 from a predefined list of test geometries (test geometries were explained in
 section~\ref{sec:automated-tests}).
 
+Besides embedded in this document, this article itself, and code for this
+article are accessible on github as of 2021-05-21\cite{wmsql}.
+
 Instructions how to re-generate all the visualizations are found in
 appendix~\ref{sec:code-regenerate}. The visualization code serves as a good
 example reference for anyone willing to start using the algorithm.
@@ -1319,7 +1324,12 @@ This section contains code listings of a subset of files tightly related to the
 Like explained in section~\ref{sec:reproducing-the-paper}, illustrations in
     this paper are generated from a small list of sample geometries. To observe
     the source geometries or regenerate this paper, run this script (assuming
-    name of this document is {\tt mj-msc-full.pdf}):
+    name of this document is \textsc{mj-msc-full.pdf}).
+
+This script will extract the source files from the \textsc{mj-msc-full.pdf} to
+    a temporary directory, run the top-level \textsc{make} command, and display
+    the generated document. Source code for the algorithm, as well as other
+    supporting files, can be found in the temporary directory.
 
 \inputcode{bash}{extract-and-generate}