{"record":{"id":"87ff900fea7b5952","repo":"jdx/mise","slug":"idiomatic-version-files-markers-are-reversed","errorCode":null,"errorMessage":"idiomatic version files markers are reversed","messagePattern":"idiomatic version files markers are reversed","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/cli/render_help.rs","lineNumber":41,"sourceCode":"            cmd!(\"prettier.cmd\", \"--write\", \"docs/.vitepress/cli_commands.ts\").run()?;\n        } else {\n            cmd!(\"prettier\", \"--write\", \"docs/.vitepress/cli_commands.ts\").run()?;\n        }\n        Ok(())\n    }\n}\n\nfn render_idiomatic_version_files() -> Result<()> {\n    let path = \"docs/configuration.md\";\n    let content = file::read_to_string(path)?;\n    let start = content\n        .find(IDIOMATIC_FILES_START)\n        .wrap_err(\"missing idiomatic version files start marker\")?\n        + IDIOMATIC_FILES_START.len();\n    let end = content\n        .find(IDIOMATIC_FILES_END)\n        .wrap_err(\"missing idiomatic version files end marker\")?;\n    ensure!(start <= end, \"idiomatic version files markers are reversed\");\n\n    let table = render_idiomatic_version_files_table();\n    let rendered = format!(\n        \"{}\\n\\n{}\\n\\n{}\",\n        &content[..start],\n        table.trim(),\n        &content[end..]\n    );\n    file::write(path, rendered)?;\n    Ok(())\n}\n\nfn render_idiomatic_version_files_table() -> String {\n    let rows = registry::baked_registry()\n        .iter()\n        .filter(|(plugin, tool)| *plugin == tool.short && !tool.idiomatic_files.is_empty())\n        .map(|(plugin, tool)| {\n            let files = tool","sourceCodeStart":23,"sourceCodeEnd":59,"githubUrl":"https://github.com/jdx/mise/blob/afd2eddd3a50c16190efc1c7e94404b48f72af57/src/cli/render_help.rs#L23-L59","documentation":"Docs-consistency guard in render_idiomatic_version_files: the idiomatic version files section markers in docs/configuration.md are out of order — the END marker appears before (or is misplaced relative to) the START marker, so the generated region cannot be extracted correctly. Fires during `mise run render` when the doc template was edited incorrectly.","triggerScenarios":"Thrown at src/cli/render_help.rs:41 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check docs/configuration.md and place IDIOMATIC_FILES_START before IDIOMATIC_FILES_END","Restore the markers if an edit removed or duplicated one","Re-run `mise run render` after fixing the doc"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"afd2eddd3a50c16190efc1c7e94404b48f72af57","analyzedAt":"2026-09-09T01:38:25.179Z","contentChangedAt":"2026-09-09T01:38:25.179Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}