remark-lint VS vale

we first looked into Vale but are moving to Remark Lint. Both have VS Code extensions so you can have it prompt you as you work.

I want to just give a shout out to Remark which is a linter for your READMEs which makes so much sense to me. Our code should be of a consistent standard, so why not the READMEs too!

With our dependencies all installed, we can start creating a .remarkrc.js, which will contain all the plugins that will be consumed by the remark processor. For details about alternative or advanced configurations, please refer to Configuring remark-lint.

For a more-classic, more-human experience (i.e., computer flags potential issues, you decide and correct if necessary) there are proselint and vale.sh.

https://github.com/amperser/proselint

https://vale.sh/

Surprised coming into this that I don't see anyone mentioning vale[0]. I've been using it for ~4 years now and love it.

I use grammarly briefly when it came out and liked the idea. Admittedly it has more polish than vale for people writing in google docs, &c. Still, I stick with Vale. Is there any case for moving to Harper?

[0] https://vale.sh/

In the same space, I recommend checking out the Vale linter. Fairly powerful and open source, too. And doesn't rely on a backend.

https://vale.sh

Vale is a code prose checker. It takes a more opinionated approach to editorial style, and thus can require lots of tuning, but it is very extensible. Let’s have it check for TODOs. Run trunk check enable vale to get started.