Skip to content

Commit 7c41035

Browse files
authored
Update README.md
1 parent 4339098 commit 7c41035

File tree

1 file changed

+12
-8
lines changed

1 file changed

+12
-8
lines changed

README.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# Upload a GitHub release to Zenodo
22

3-
This is a Github action to update your `codemeta.json`, `CITATION.cff` and `.zenodo.json` files with the release information and then upload your release to Zenodo.
3+
This is a Github action to update your `codemeta.json`, `CITATION.cff`, and `.zenodo.json` files with the release information and then upload your release to Zenodo.
44

5-
This action uses the **tag name** of the release to update the `version` field in the metadata files. Be sure to use the correct tag name. Within your tag name a valid `semver` version should be present.
5+
This action uses the **tag name** of the release to update the `version` field in the metadata files. Be sure to use the correct tag name. Within your tag name, a valid `semver` version should be present.
66

7-
When update metadata files are added to your repository, the action will automatically send the new metadata files in its release. This will also mean that your Github release will not contain the updated metadata files. To avoid this, you can set the `update_metadata_files` option to `false` and add a `.zenodo.json` file.
7+
When updated metadata files are added to your repository, the action will automatically send the new metadata files in its release. This will also mean that your GitHub release will not contain the updated metadata files. To avoid this, you can set the `update_metadata_files` option to `false` and add a `.zenodo.json` file.
88

9-
Remember to remove the webhook from your repository before using this action. Otherwise, you will have two releases on Zenodo for every release on Github.
9+
Remember to remove the webhook from your repository before using this action. Otherwise, you will have two releases on Zenodo for every release on GitHub.
1010

11-
Currently the following files and fields will be updated:
11+
Currently, the following files and fields will be updated:
1212

1313
* `codemeta.json`:
1414
* `version`: The release version
@@ -17,13 +17,13 @@ Currently the following files and fields will be updated:
1717
* `CITATION.cff`:
1818
* `version`: The release version
1919
* `identifiers`: The release identifier (Zenodo version specific doi).
20-
This action currently assumes your old zenodo doi is the first item in the list.
20+
This action assumes your old zenodo doi is the first item in the list.
2121

2222
* `.zenodo.json`:
2323
* `version`: The release version
2424

2525
* `docs.compatibility.json`
26-
* A new entry will be added in this file. This entry is meant for versioned Docusaurus projects
26+
* A new entry will be added to this file. This entry is meant for versioned Docusaurus projects
2727
* `docsVersion` - The new docs version
2828
* `appVersion` - The latest app version
2929

@@ -80,7 +80,7 @@ jobs:
8080
name: A job to update metadata and push a release to Zenodo
8181

8282
steps:
83-
# This step is not needed at the moment but might decide to add on more steps in the future
83+
# This step is not needed at the moment but I might decide to add more steps in the future
8484
- name: Set up Node.js
8585
uses: actions/setup-node@v3
8686
with:
@@ -118,3 +118,7 @@ git commit -a -m "chore: release action v1.2.3"
118118
git tag -a -m "Action v1.2.3 release" v1.2.3
119119
git push --follow-tags
120120
```
121+
122+
## PS
123+
124+
I originally built this to handle auto-deploying our Docusaurus documentation sites to Zenodo. This was my first GitHub action so I'm hoping to improve this soon. We have since created another tool that you might be interested in for deploying your research software to Zenodo. [Codefair](https://codefair.io) is a free and open source GitHub app that acts as your personal assistant when it comes to making your research software reusable and especially complying with the Findable, Accessible, Interoperable, Reusable (FAIR) Principles for Research Software (FAIR4RS Principles)

0 commit comments

Comments
 (0)