{"record":{"id":"f5625a6e46702dcf","repo":"vectordotdev/vector","slug":"invalid-fragment-contents-for-filename-authors-should-be","errorCode":null,"errorMessage":"invalid fragment contents for '{filename}': authors should be space delimited, not comma delimited.","messagePattern":"invalid fragment contents for '(.+?)': authors should be space delimited, not comma delimited\\.","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"vdev/src/commands/check/changelog_fragments.rs","lineNumber":215,"sourceCode":"    // line must be the last line, no trailing blank lines allowed.\n    let last_line = content.lines().last().unwrap_or(\"\");\n\n    let Some(names) = last_line.strip_prefix(\"authors: \") else {\n        bail!(\n            \"invalid fragment contents for '{filename}': last line must be 'authors: <name> [<name> ...]' (no trailing blank lines).\"\n        );\n    };\n    let names = names.trim();\n    if names.is_empty() {\n        bail!(\"invalid fragment contents for '{filename}': authors line has no names.\");\n    }\n    if names.contains('@') {\n        bail!(\n            \"invalid fragment contents for '{filename}': author names should not be prefixed with '@'.\"\n        );\n    }\n    if names.contains(',') {\n        bail!(\n            \"invalid fragment contents for '{filename}': authors should be space delimited, not comma delimited.\"\n        );\n    }\n    if names.split_whitespace().any(|n| n == TODO_HANDLE) {\n        bail!(\n            \"invalid fragment contents for '{filename}': the scaffolder placeholder '{TODO_HANDLE}' must be replaced with a real GitHub handle.\"\n        );\n    }\n\n    // Reject any scaffolded body placeholder that the author forgot to fill in.\n    // All templates start their placeholder lines with a literal `TODO ` at column 0,\n    // which is rare in real fragment text.\n    if let Some(bad) = content.lines().find(|l| l.starts_with(\"TODO \")) {\n        bail!(\n            \"invalid fragment contents for '{filename}': scaffolder placeholder line still present ({bad:?}). Replace it with real content.\"\n        );\n    }\n","sourceCodeStart":197,"sourceCodeEnd":233,"githubUrl":"https://github.com/vectordotdev/vector/blob/bdb87aeaa4c4ff27c0ba643c1c77b21bf2ef4013/vdev/src/commands/check/changelog_fragments.rs#L197-L233","documentation":"Fired by validate_contents after stripping the 'authors: ' prefix from the last line of the fragment. If the remaining names string contains commas, the fragment is rejected because the authors line must be space-delimited; commas typically indicate a copy-pasted author list that the changelog generator cannot split correctly.","triggerScenarios":"Running `vdev check changelog-fragments` when the last line contains any ',', e.g. `authors: jdoe, asmith`.","commonSituations":"Listing multiple authors in prose style ('Jane, Bob'); converting a YAML-style list to the authors line without switching delimiters.","solutions":["Replace commas with spaces between author handles.","Verify the final line reads `authors: handle1 handle2 ...`.","Re-run the check after editing."],"exampleFix":"// before\nauthors: jdoe, asmith\n// after\nauthors: jdoe asmith","handlingStrategy":"validation","validationCode":"let names = last.strip_prefix(\"authors: \").unwrap_or(\"\").trim();\nassert!(!names.contains(','), \"separate authors with spaces, not commas\");","typeGuard":null,"tryCatchPattern":null,"preventionTips":["List multiple authors space-delimited: `authors: a b c`.","Don't format the authors line like prose or a YAML list.","Check for ',' on the authors line before committing."],"tags":["rust","changelog","validation","ci"],"backgroundTag":"invalid-argument-format","analyzedSha":"bdb87aeaa4c4ff27c0ba643c1c77b21bf2ef4013","analyzedAt":"2026-09-16T02:53:35.741Z","contentChangedAt":"2026-09-16T02:53:35.741Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}