Merge pull request #1362 from cthoyt/patch-1

Add ROR affiliation links to example paper

docs/example_paper.md

@@ -31,6 +31,7 @@ authors:
 affiliations:
  - name: Lyman Spitzer, Jr. Fellow, Princeton University, USA
    index: 1
+   ror: 00hx57361
  - name: Institution Name, Country
    index: 2
  - name: Independent Researcher, Country
@@ -191,4 +192,4 @@ Example `paper.bib` file:
 }
 ```
 
-Note that the paper begins by a metadata section (the enclosing --- lines are mandatory) and ends with a References heading, and the references are built automatically from the content in the `.bib` file. You should enter in-text citations in the paper body following correct [Markdown citation syntax](https://pandoc.org/MANUAL.html#extension-citations).  Also note that the references include full names of venues, e.g., journals and conferences, not abbreviations only understood in the context of a specific discipline.
+Note that the paper begins by a metadata section (the enclosing --- lines are mandatory) and ends with a References heading, and the references are built automatically from the content in the `.bib` file. You should enter in-text citations in the paper body following correct [Markdown citation syntax](https://pandoc.org/MANUAL.html#extension-citations).  Also note that the references include full names of venues, e.g., journals and conferences, not abbreviations only understood in the context of a specific discipline.

docs/paper.md

@@ -98,6 +98,29 @@ authors:
   <!--     given-names: 瀧 -->
   <!--     surname: 立花 -->
 
+## Affiliations
+
+Each affiliation requires an `index` and `name`.
+
+Optionally, the Research Organization Registry (ROR) identifier for the top-level
+organization can be annotated with the `ror` key. Note that ROR does not include
+departments in its [scope](https://ror.org/registry/#scope-and-criteria-for-inclusion),
+so ROR annotations are typically made to the top-level organization.
+
+```yaml
+authors:
+  - name: Albert Krewinkel
+    affiliation: [ 1, 2, 3 ]
+
+affiliations:
+  - index: 1
+    name: Open Journals
+  - index: 2
+    name: Pandoc Development Team
+  - index: 3
+    name: Technische Universitaet Hamburg
+    ror: 04bs1pb34
+```
 
 ## Internal references