Cleanup and revert

example/paper.md

@@ -7,26 +7,14 @@ authors:
     affiliation: [ 1, 2, 4 ]
     orcid: 0000-0002-9455-0796
     corresponding: true
-    roles:
-      - type: methodology
-      - type: software
-        degree: equal
   - name: Juanjo Bazán
     orcid: 0000-0001-7699-3983
     affiliation: [ 1 ]
     equal-contrib: true
-    roles:
-      - type: software
   - name: Arfon M. Smith
     orcid: 0000-0002-3957-2474
     affiliation: [ 1, 3 ]
     equal-contrib: true
-    roles:
-      - type: methodology
-      - type: software
-        degree: equal
-      - type: supervision
-        degree: lead
 affiliations:
   - index: 1
     name: Open Journals
@@ -465,6 +453,30 @@ authors:
       - 'supervision'
 ```
 
+## 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
 
 Markdown has no default mechanism to handle document internal