Skip to content

Commit 9f1994e

Browse files
committed
Add intro to DOI exercise and glossary entries
1 parent 4a52f62 commit 9f1994e

File tree

2 files changed

+50
-1
lines changed

2 files changed

+50
-1
lines changed

modules/05-sharing-and-publishing/index.md

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -816,7 +816,24 @@ Click the link to immediately open your website.
816816

817817
## Getting a DOI
818818

819-
TODO
819+
A {term}`DOI` can uniquely identify and track your research products, enabling easy
820+
citing and tracking of citations.
821+
DOIs can even be versioned, enabling citations to reference a research product at a
822+
specific point in time.
823+
824+
DOIs can be associated with your unique academic identity through the use of
825+
an {term}`ORCID`.
826+
827+
:::{important}
828+
A DOI and ORCID can help defend your work against {term}`scooping` by providing
829+
verifiable {term}`provenance` for your work, making it clear that your work came first.
830+
831+
They can also enable credit for the work to be more equitably distributed by crediting
832+
all forms of contributions.
833+
:::
834+
835+
We can automate the production of DOIs with GitHub and [Zenodo](https://zenodo.org/) (a
836+
**free** DOI registrar developed and operated by [CERN](https://home.cern/)).
820837

821838

822839
### 💪 Exercise E: Get a DOI for your published content on GitHub

reference/00-vocabulary.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,42 @@
11
# 🔍 Vocabulary
22

33
:::{glossary}
4+
DOI
5+
: A "Digital Object Identifier" is a string of characters (e.g.
6+
<https://doi.org/10.48550/arXiv.2310.00865>) that uniquely identifies an object (_any_
7+
object: physical, digital, or conceptual).
8+
[Read more on the official DOI website](https://www.doi.org/the-identifier/what-is-a-doi/).
9+
10+
411
Frontmatter
512
: A way of embedding metadata with [YAML](https://yaml.org/) at the front (top) of a
613
document.
714
Frontmatter can be embedded at the top of a Markdown document or in the first Markdown
815
cell of a Jupyter Notebook.
916
[Read more in the official MyST frontmatter docs](https://mystmd.org/guide/frontmatter).
17+
18+
Open science
19+
: A movement to make research products (papers, data, software) and processes accessible
20+
to everyone.
21+
A more stringent interpretation of open science involves enabling not just access, but
22+
collaboration, throughout the scientific process, not just at the end.
23+
[Read more on Wikipedia](https://en.wikipedia.org/wiki/Open_science).
24+
25+
ORCID
26+
: An "Open Researcher and Contributor ID" that uniquely identifies an academic
27+
contributor and enables tracking and associating their identity with {term}`DOIs <DOI>`.
28+
[Read more on the official ORCID website](https://info.orcid.org/what-is-orcid/).
29+
30+
Provenance
31+
: The history or chronology of a thing.
32+
The provenance of your research products can be established and verified by publishing
33+
the source code and creating {term}`DOIs <DOI>`.
34+
35+
Scooping
36+
: Being "beaten to the punch" or left in second place in the attempt to publish research
37+
or a discovery.
38+
This term is often used as a counter-argument for {term}`open science` by implying that
39+
sharing your work openly will result in plagiarism.
40+
For more, please read
41+
[Afraid of Scooping – Case Study on Researcher Strategies against Fear of Scooping in the Context of Open Science](https://doi.org/10.5334/dsj-2017-029).
1042
:::

0 commit comments

Comments
 (0)