aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorMohammad Akhlaghi <mohammad@akhlaghi.org>2018-02-08 01:17:03 +0100
committerMohammad Akhlaghi <mohammad@akhlaghi.org>2018-02-08 01:17:03 +0100
commit6a1bc7481b204988b76f974cf37cc8875c8e582d (patch)
treeb629d99093a2fe554cc3487c7fc81a0fbc69ef5c /README.md
parent17da9975e8b9f925e40da4bb268a26f7b853f770 (diff)
Basic titles now corrected after copyright in README.md
The basic title, short description and author section of the checklist was moved immediately after copyright because it is more related to it. The description of Gnuastro is now before `README' because the user will confront Gnuastro in `README' and this will provide a good introduction on what to do with it.
Diffstat (limited to 'README.md')
-rw-r--r--README.md34
1 files changed, 16 insertions, 18 deletions
diff --git a/README.md b/README.md
index 014e974..391bed2 100644
--- a/README.md
+++ b/README.md
@@ -117,6 +117,7 @@ Make manual there also.
+
Checklist to customize the pipeline
===================================
@@ -141,6 +142,16 @@ been explained here), please let us know to correct it.
files, always remember to add a similar copyright statement at the top
of the tile.
+ - **Title**, **short description** and **author** of project: In this raw
+ skeleton, the title or short descripton of your project should be
+ added in the following two files: `Makefile` (the first line), and
+ `tex/preamble-style.tex` (the last few lines, along with the names of
+ you and your colleagues). In both cases, the texts you should replace
+ are all in capital letters to make them easier to identify. Ofcourse,
+ if you use a different LaTeX method of managing the title and authors,
+ please feel free to use your own methods, just find a way to keep the
+ pipeline version in a nicely visible place.
+
- **Gnuastro**: GNU Astronomy Utilities (Gnuastro) is currently a
dependency of the pipeline and without it, the pipeline will complain
and abort. The main reason for this is to demonstrate how critically
@@ -157,18 +168,6 @@ been explained here), please let us know to correct it.
- Delete everything about Gnuastro in `reproduce/src/make/initialize.mk`.
- Delete `and Gnuastro \gnuastroversion` from `tex/preamble-style`.
-
- - **Title**, **Short description** and **author** of project: In this raw
- skeleton, the title or short descripton of your project should be
- added in the following two files: `Makefile` (the first line), and
- `tex/preamble-style.tex` (the last few lines, along with the names of
- you and your colleagues). In both cases, the texts you should replace
- are all in capital letters to make them easier to identify. Ofcourse,
- if you use a different LaTeX method of managing the title and authors,
- please feel free to use your own methods, just find a way to keep the
- pipeline version in a nicely visible place.
-
-
- **`README`**: Go through this top-level instruction file and make it fit
to your pipeline: update the text and etc. Don't forget that your
colleagues or anyone else, will first be drawn to read this file, so
@@ -176,7 +175,6 @@ been explained here), please let us know to correct it.
work. Therefore, also check and update `README` one last time when you
are ready to publish your work (and its reproduction pipeline).
-
- **First input dataset**: The user manages the top-level directory of the
input data through the variables set in
`reproduce/config/pipeline/DIRECTORIES.mk.in` (the user actually edits
@@ -207,7 +205,6 @@ been explained here), please let us know to correct it.
necessary for your research to the pipeline based on the example
above.
-
- **Initiate a new Git repo**: You don't want to mix the history of this
template reproduction pipeline with your own reproduction
pipeline. You have already made some small changes in the previous
@@ -236,6 +233,9 @@ been explained here), please let us know to correct it.
with us as you go along so we can make this a more robust skeleton.
+
+
+
Tips on using the pipeline
==========================
@@ -394,10 +394,8 @@ way, we can add it here for others to also benefit.
-
-
-Appendix: Introduction to this concept from link above
-======================================================
+Appendix: Necessity of exact reproduction in scientific research
+================================================================
In case [the link above](http://akhlaghi.org/reproducible-science.html) is
not accessible at the time of reading, here is a copy of the introduction