0003. write changes manifests only for fields you list
- Status: accepted
- Date: 2026-10-28
Context
Citation files exist to hold this metadata, so write may rewrite them freely. A package manifest is different: a release tool often owns its version, and a rewrite can fight that tool.
Decision
write always updates citation files that are not the source. It changes a manifest only for the fields in write-manifests, or for every writable field with "all", which suits repos with no release tool. The default is none.
write changes values already there and never adds a field, so a .zenodo.json without a version stays without one. A new citation file is created only when files in config lists it.
Consequences
- A default
writecannot disturb a release tool. - A manifest finding that
writemay not fix is reported with what to do: edit by hand, or add the field towrite-manifests. - Details are in How write works and Configuration.