aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBoud Roukema <boud@cosmo.torun.pl>2020-07-20 18:15:12 +0200
committerMohammad Akhlaghi <mohammad@akhlaghi.org>2020-07-20 22:36:08 +0100
commit2bfe5e16a0ba8198d9a77d6e36c17ac5daed7705 (patch)
tree5c7e5eaa1285ab5b896ae24d88996623eb606a4f
parent2ed8a2d60bc991ad06411b2aab43989a64a59a2d (diff)
README-hacking.md: clarify Zenodo usage in publication checklist
This commit clarifies the initial usage of Zenodo for reserving a Zenodo identifier and starting an 'unpublished' upload. Some other minor wording changes are done here.
-rw-r--r--README-hacking.md31
-rw-r--r--reproduce/analysis/make/verify.mk4
2 files changed, 25 insertions, 10 deletions
diff --git a/README-hacking.md b/README-hacking.md
index 554ba6b..21624a0 100644
--- a/README-hacking.md
+++ b/README-hacking.md
@@ -678,7 +678,7 @@ First custom commit
$ ./project make
```
- 7. **Ingore changes in some Maneage files**: One of the main advantages of
+ 7. **Ignore changes in some Maneage files**: One of the main advantages of
Maneage is that you can later update your infra-structure by merging
your `master` branch with the `maneage` branch. This is good for many
low-level features that you will likely never modify yourself. But it
@@ -929,23 +929,29 @@ future.
- **Reserve a DOI for your dataset**: There are multiple data servers that
give this functionality, one of the most well known and (currently!)
well-funded is [Zenodo](https://zenodo.org) so we'll focus on it
- here. Ofcourse, you can use any other service that provides a similar
+ here. Of course, you can use any other service that provides a similar
functionality. Once you complete these steps, you can start using/citing
your dataset's DOI in the source of your project to finalize the rest of
- the points. Note that with Zenodo, you can even use the given identifier
+ the points. With Zenodo, you can even use the given identifier
for things like downloading.
- * *Start new upload*: After you log-in to Zenodo, you can start a new
+ * *Start new upload*: After you log in to Zenodo, you can start a new
upload by clicking on the "New Upload button".
* *Reserve DOI*: Under the "Basic information" --> "Digital Object
Identifier", click on the "Reserve DOI" button.
- * *Fill basic info*: You need to atleast fill the "required fields"
- (marked with a red star).
+ * *Fill basic info*: You need to at least fill in the "required fields"
+ (marked with a red star). You will always be able to change any
+ metadata (even after you "Publish"), so don't worry too much about
+ values in the fields, at this phase, its just important that they
+ are not empty.
- * *Save your upload*: You should now be able to press the "Save" button
- (at the top or bottom of the page) to finalize this step.
+ * *Save your project but do not yet publish*: Press the "Save" button
+ (at the top or bottom of the page). Do not yet press "Publish"
+ though, since that would make the project public, and freeze the DOI
+ with any possible file you may have uploaded already. We will get to
+ the publication phase in the next steps.
- **Request archival on SoftwareHeritage**: [Software
Heritage](https://archive.softwareheritage.org/save/) is an online
@@ -1170,6 +1176,15 @@ future.
are public). If not, you can mention that everything is ready for such a
submission after acceptance.
+ - **Future versions**: Both Zenodo and arXiv allow uploading new versions
+ after your first publication. So it is recommended to put more recent
+ versions of your published projects later (for example after applying
+ the changes suggested by the referee). In Zenodo (unlike arXiv), you
+ only need to publish a new version if the uploaded files have
+ changed. You can always update the project's metadata with no effect on
+ the DOI (so you don't need to upload a new version if you just want to
+ update the metadata).
+
diff --git a/reproduce/analysis/make/verify.mk b/reproduce/analysis/make/verify.mk
index 69711d5..b3d62f2 100644
--- a/reproduce/analysis/make/verify.mk
+++ b/reproduce/analysis/make/verify.mk
@@ -22,7 +22,7 @@
# Verification functions
# ----------------------
#
-# These functions are used by the final rule in this Makefil
+# These functions are used by the final rule in this Makefile
verify-print-error-start = \
echo; \
echo "VERIFICATION ERROR"; \
@@ -87,7 +87,7 @@ verify-txt-no-comments-no-space = \
# -------------------------------------------
#
# This is the FINAL analysis step (before going onto the paper. Please use
-# this step to veryify the contents of the figures/tables used in the paper
+# this step to verify the contents of the figures/tables used in the paper
# and the LaTeX macros generated from all your processing. It should depend
# on all the LaTeX macro files that are generated (their contents will be
# checked), and any files that go into the tables/figures of the paper