Render authors from YAML front matter

[lubianat]

First step towards a system with more automation/standardization for rfc status management.

German-BioImaging/ome-zarr-ideas#54

• feat: build authors from yaml header
• test setup for rfc 9 comment 5

Next steps:

• Change the metadata for other reviews / comments
• Build the summary on the RFC main page from the index
• Build the overall index from the metadata on each page using a decision tree (has comment -> y, etc etc)
• Validate the front matter in target documents with a LinkML schema

EDIT: Ready to review!

To review:

• Compare the generated RFC pages with the older one.

• Provide feedback on the new look and feel and if changes are needed

• Compare the page listing the different RFCs with the older one

• If checking all 57 documents is too much, pick a sample and see if it is okay

• If you are a schema person, look at rfc/schema/front_matter.yaml for the LinkML schema

• If you are a sphinx person, look at _ext and document_authors.py and rfc_status.py and see if the directives make sense

Note that a lot of the code and changes have been aided by a Claude Opus 5 agent, though I tried to steer for minimal changes and maximize readability.

[github-actions]

Automated Review URLs

• Readthedocs

[jo-mueller]

Might benefit from a template, i.e. for RFCs and comments?

[jo-mueller]

Also; it may be worth to drop the affiliations from the rendered text, similar to how it's done at ngff-spec. The reasoning there was, that a person's orcid is likely informative enough about past and present affiliations.

[lubianat]

a person's orcid is likely informative enough about past and present affiliations.

in theory, yes, it should. in practice, I need to keep the information provided by the authors on under which affiliation that comment was made.

an example is the rfc 9 / comment 5

Anna Kreshuk - ilastik was the intended affiliation, though that is a project and not an employee, and not listed on https://orcid.org/0000-0003-1334-6388