Skip to content

vscode: associate dotfiles to stop markdownlint false positives - #2

Merged
cewert merged 1 commit into
mainfrom
vscode/dotfile-associations
May 21, 2026
Merged

vscode: associate dotfiles to stop markdownlint false positives#2
cewert merged 1 commit into
mainfrom
vscode/dotfile-associations

Conversation

@cewert

@cewert cewert commented May 21, 2026

Copy link
Copy Markdown
Member

Summary

VSCode's markdownlint extension flags dotfiles whose first line happens to start with # (gitignore/properties comment) or --- (YAML doc start) as malformed markdown — spurious lint warnings in the IDE on files that aren't markdown.

Fix: files.associations entries in .vscode/settings.json so VSCode applies the right language mode and the markdownlint extension stays out of these files.

Pure IDE config — zero effect on CI, build, or runtime.

Mirrors the same pattern landed in jellyrock/docs#1.

Part of

Org-wide IDE hygiene followup to the Renovate consolidation. One PR per repo so it's reviewable independently.

Test plan

  • No CI impact (files.associations only)
  • After merge: reopening the workspace in VSCode no longer shows markdownlint warnings on the listed dotfiles

The IDE's markdownlint extension flags dotfiles whose first line happens
to start with '#' (gitignore/properties comments) or '---' (YAML start)
as malformed markdown. None of those are markdown; the fix is a one-
line files.associations entry per dotfile that's affected in this repo.

Pure IDE config change — zero effect on CI, build, or runtime.
Matches the pattern landed in jellyrock/docs#1.
@cewert
cewert force-pushed the vscode/dotfile-associations branch from 48f1e39 to e2af778 Compare May 21, 2026 17:02
@cewert
cewert merged commit 3a11584 into main May 21, 2026
1 check passed
@cewert
cewert deleted the vscode/dotfile-associations branch May 21, 2026 17:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant