Skip to content

Conversation

@rvedotrc
Copy link
Contributor

@rvedotrc rvedotrc commented Apr 20, 2025

  • make it easier to run validate-links, without also running prettier and markdownlint
  • add "watch" mode for the linter
  • try to report the source location of found problems
  • provide the various lint modes as npm scripts
  • provide the non-fix lint modes as VSCode tasks

This means that, if you're using VS Code, you could use the ./lint (watch) task continuously to check for problems.

If you prefer to let VS Code extensions do the markdownlint and prettier parts, you might want to use the ./lint validate-tasks (watch) task, to focus just on that part.

@rvedotrc rvedotrc marked this pull request as ready for review April 20, 2025 10:52
@rvedotrc rvedotrc requested a review from a team April 20, 2025 10:53
@urbanogilson
Copy link
Member

Would it make sense to include the Markdownlint extension for VS Code in our recommended setup? It helps catch common Markdown style issues and ensures consistency across the team.

We could also suggest this setting in .vscode/settings.json:

{
  "markdownlint.run": "onSave"
}

This way, formatting feedback is automatic and low-friction.

@rvedotrc
Copy link
Contributor Author

If that works for you, then sure, why not. The workflow yaml would of course need to remain in place regardless.

@rvedotrc rvedotrc changed the base branch from linting to main April 21, 2025 08:10
@adamblanchard
Copy link
Contributor

Pardon my ignorance, but could Markdownlint extension and our linting tasks highlight the same issues? Or might they be inconsistent with each other?

@rvedotrc
Copy link
Contributor Author

I'm not sure either. I would hope that they agree, but I acknowledge that I have no guarantee of that.

(FYI the lint workflow / script is markdownlint + prettier).

Copy link
Contributor

@adamblanchard adamblanchard left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm approving because the markdown extension suggestion shouldn't block us merging this anyhow. Feel free to raise an issue/another pr to explore and add the markdown extension recommendation (only if they can match the same rules, i say).

@rvedotrc rvedotrc marked this pull request as draft April 22, 2025 12:55
@rvedotrc
Copy link
Contributor Author

Back to draft, because I'm not happy with the "watch" version. It has seemed unstable and I want to get to the bottom of why that is.

@rvedotrc rvedotrc marked this pull request as ready for review April 27, 2025 07:45
@rvedotrc rvedotrc marked this pull request as draft April 27, 2025 09:42
@rvedotrc rvedotrc marked this pull request as ready for review April 28, 2025 04:51
@rvedotrc rvedotrc requested review from a team and adamblanchard April 28, 2025 04:51
@rvedotrc rvedotrc changed the title Provide lint and lint:watch with VSCode config lint: source location reporting, "watch", and VS Code tasks Apr 28, 2025
Copy link
Contributor

@adamblanchard adamblanchard left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about putting lint, ts files and "dist" into a subdirectory like e.g. "scripts" for now?

@rvedotrc rvedotrc requested a review from a team April 29, 2025 06:52
@rvedotrc
Copy link
Contributor Author

How about putting lint, ts files and "dist" into a subdirectory like e.g. "scripts" for now?

Done. Also, 'dist' is no longer committed.

@adamblanchard adamblanchard merged commit d763f57 into main Apr 29, 2025
1 check passed
@rvedotrc rvedotrc deleted the linting-tasks branch April 29, 2025 07:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

4 participants