aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorMohammad Akhlaghi <mohammad@akhlaghi.org>2019-09-18 12:52:38 +0100
committerMohammad Akhlaghi <mohammad@akhlaghi.org>2019-09-18 12:52:38 +0100
commit67bc85c30ba1885ace3d0d282724adf227e7a5f3 (patch)
tree0e1633b2cc77fc8ee12b2263ca0e8a7f80a3a93f /README.md
parente8a05d4c9a03d28e6a962b37c967f31ee93a7183 (diff)
README.md written to be more generic and easy to customize
Until now customizing it was a little more detailed, for example the copyright statement wasn't generic and was about "this template". So the user would have to correct it. With this commit, the copyright statment just says "this project", so it can apply to the raw template and also any customization of it. Also, some minor edits were made in the various parts of the text to make it more clear.
Diffstat (limited to 'README.md')
-rw-r--r--README.md75
1 files changed, 38 insertions, 37 deletions
diff --git a/README.md b/README.md
index c786b40..7129b07 100644
--- a/README.md
+++ b/README.md
@@ -1,30 +1,31 @@
-Reproducible source for paper XXXXXXX
-=====================================
+Reproducible source for XXXXXXXXXXXXXXXXX
+=========================================
Copyright (C) 2018-2019 Mohammad Akhlaghi <mohammad@akhlaghi.org>\
See the end of the file for license conditions.
-This is the reproducible project source for the paper titled "**XXXXXX**",
-by XXXXXXXX et al. (**IN PREPARATION**). To learn more about the purpose,
-principles and technicalities of this reproducible paper, please see
-`README-hacking.md`.
+This is the reproducible project source for the paper titled "**XXX XXXXX
+XXXXXX**", by XXXXX XXXXXX, YYYYYY YYYYY and ZZZZZZ ZZZZZ that is published
+in XXXXX XXXXX.
-To reproduce our results, the only dependency is a minimal Unix-based
-building environment including a C compiler (already available on your
-system if you have ever built and installed a software from source) and a
-downloader (Wget or cURL). Note that **Git is not mandatory**: if you don't
-have Git to run the first command below, go to the URL given in the command
-on your browser, and download them manually (there is a button to download
-a compressed tarball of the project).
+To reproduce the results and final paper, the only dependency is a minimal
+Unix-based building environment including a C compiler (already available
+on your system if you have ever built and installed a software from source)
+and a downloader (Wget or cURL). Note that **Git is not mandatory**: if you
+don't have Git to run the first command below, go to the URL given in the
+command on your browser, and download the project's source (there is a
+button to download a compressed tarball of the project).
```shell
-$ git clone XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+$ git clone XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
$ ./project configure
-$ ./project make -j8
+$ ./project make
```
-For a general introduction to reproducible science as implemented in this
-project, please see the [principles of reproducible
+To learn more about the purpose, principles and technicalities of this
+reproducible paper, please see `README-hacking.md`. For a general
+introduction to reproducible science as implemented in this project, please
+see the [principles of reproducible
science](http://akhlaghi.org/reproducible-science.html), and a
[reproducible paper
template](https://gitlab.com/makhlaghi/reproducible-paper) that is based on
@@ -37,7 +38,8 @@ it.
Building the project
--------------------
-This project was designed to have as few dependencies as possible.
+This project was designed to have as few dependencies as possible without
+requiring root/administrator permissions.
1. Necessary dependencies:
@@ -45,20 +47,20 @@ This project was designed to have as few dependencies as possible.
tools found on any Unix-like operating system (GNU/Linux, BSD, Mac
OS, and others). All necessary dependencies will be built from
source (for use only within this project) by the `./project
- configure' script (next step).
+ configure` script (next step).
1.2: (OPTIONAL) Tarball of dependencies. If they are already present (in
a directory given at configuration time), they will be
used. Otherwise, a downloader (`wget` or `curl`) will be necessary
to download any necessary tarball. The necessary tarballs are also
- collected in the link below for easy download. [[TO PROJECT
- DESIGNERS: it is STRONGLY RECOMMENDED to keep a backup of all the
- necessary software tarballs you need for the project (possibly in
- another Git repository). For example see [this template's
- dependencies](https://gitlab.com/makhlaghi/reproducible-paper-dependencies).
- Please add a similar address for your project here.]]
-
- https://XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ collected in the archived project on Zenodo (link below) [[TO
+ AUTHORS: UPLOAD THE SOFTWARE TARBALLS WITH YOUR DATA AND PROJECT
+ SOURCE TO ZENODO OR OTHER SIMILAR SERVICES. THEN ADD THE DOI/LINK
+ HERE.DON'T FORGET THAT THE SOFTWARE ARE A CRITICAL PART OF YOUR
+ WORK.]]. Just unpack that tarball, and when `./project configure`
+ asks for the "software tarball directory", give the address of the
+ unpacked directory that has all the tarballs.
+ https://doi.org/10.5281/zenodo.3408481
2. Configure the environment (top-level directories in particular) and
build all the necessary software for use in the next step. It is
@@ -73,7 +75,7 @@ This project was designed to have as few dependencies as possible.
```
3. Run the following command (local build of the Make software) to
- reproduce all the analysis and build the final `paper.pdf` on *8*
+ reproduce all the analysis and build the final `paper.pdf` on `8`
threads. If your CPU has a different number of threads, change the
number (you can see the number of threads available to your operating
system by running `./.local/bin/nproc`)
@@ -90,20 +92,19 @@ Copyright information
---------------------
This file and `.file-metadata` (a binary file, used by Metastore to store
-file dates when doing Git checkouts) are part of the reproducible paper
-template (https://gitlab.com/makhlaghi/reproducible-paper) and share the
-same copyright notice (at the start of this file) and license notice
-(below).
+file dates when doing Git checkouts) are part of the reproducible project
+mentioned above and share the same copyright notice (at the start of this
+file) and license notice (below).
-This template is free software: you can redistribute it and/or modify it
+This project is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option)
any later version.
-This template is distributed in the hope that it will be useful, but
-WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
-or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+This project is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details.
You should have received a copy of the GNU General Public License along
-with Template. If not, see <https://www.gnu.org/licenses/>. \ No newline at end of file
+with this project. If not, see <https://www.gnu.org/licenses/>. \ No newline at end of file