aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorMohammad Akhlaghi <mohammad@akhlaghi.org>2018-02-08 01:11:31 +0100
committerMohammad Akhlaghi <mohammad@akhlaghi.org>2018-02-08 01:11:31 +0100
commit17da9975e8b9f925e40da4bb268a26f7b853f770 (patch)
tree49cd4cdcb43a740ec640fa88e130be836e3f8674 /README.md
parent3bf52d168e6c350446a02bc43fc1ecf2c3bd3cb9 (diff)
Moved creation of a new Git repo to the end of the checklist
The creation of a new Git repo is now moved to the end of the checklist. It was not in place as the third step before. Now, the user makes all the standard changes and just before they start going into the details of their research, they define their new repository.
Diffstat (limited to 'README.md')
-rw-r--r--README.md53
1 files changed, 30 insertions, 23 deletions
diff --git a/README.md b/README.md
index 296d889..014e974 100644
--- a/README.md
+++ b/README.md
@@ -154,30 +154,9 @@ been explained here), please let us know to correct it.
this list:
- Delete the description about Gnuastro in `README`.
- - Delete everything about Gnuastro in `reproduce/src/make/initialize.mk`
- - Delete `and Gnuastro \gnuastrover` from `tex/preamble-style`
+ - Delete everything about Gnuastro in `reproduce/src/make/initialize.mk`.
+ - Delete `and Gnuastro \gnuastroversion` from `tex/preamble-style`.
- - **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
- step, so let's re-initiate history before continuing. But before doing
- that, keep the output of `git describe` in a place and write it in
- your first commit message to document what point in this pipeline's
- history you started from. Since the pipeline is highly integrated with
- your particular research, it may not be easy to merge the changes
- later. Having the commit in this history that you started from, will
- allow you to check and manually apply any changes that don't interfere
- with your implemented pipeline. After this step, you can commit your
- changes into your newly initiated history as you like.
-
- ```shell
- $ git describe # The point in this history you started from.
- $ git clean -fxd # Remove any possibly created extra files.
- $ rm -rf .git # Completely remove this history.
- $ git init # Initiate a new history.
- $ git add --all # Stage everything that is here.
- $ git commit # Make your first commit (mention the first output)
- ```
- **Title**, **Short description** and **author** of project: In this raw
skeleton, the title or short descripton of your project should be
@@ -229,6 +208,34 @@ been explained here), please let us know to correct it.
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
+ step, so let's re-initiate history before continuing. But before doing
+ that, keep the output of `git describe` in a place and write it in
+ your first commit message to document what point in this pipeline's
+ history you started from. Since the pipeline is highly integrated with
+ your particular research, it may not be easy to merge the changes
+ later. Having the commit in this history that you started from, will
+ allow you to check and manually apply any changes that don't interfere
+ with your implemented pipeline. After this step, you can commit your
+ changes into your newly initiated history as you like.
+
+ ```shell
+ $ git describe # The point in this history you started from.
+ $ git clean -fxd # Remove any possibly created extra files.
+ $ rm -rf .git # Completely remove this history.
+ $ git init # Initiate a new history.
+ $ git add --all # Stage everything that is here.
+ $ git commit # Make your first commit (mention the first output)
+ ```
+
+ - **Start your exciting research**: You are now ready to add flesh and
+ blood to this raw skeleton by further modifying and adding your
+ exciting research steps. Just don't forget to share your experiences
+ with us as you go along so we can make this a more robust skeleton.
+
+
Tips on using the pipeline
==========================