redocusaurus VS vale

I'm also curious which OpenAPI plugin u/teranym is using—I've personally been using redocusaurus (and like it a lot), and tried docusaurus-openapi for a bit (not bad, some glitches), but I'd love to learn more about what else is out there and how people are using it!

The website was previously built with Gatsby using a custom theme. As part of the refactor, we changed it to run as part of our Docusaurus main documentation and on top of Redocly using the Redocusaurus plugin.

Great examples of this can be found on their community plugins page, where others have built plugins for offline/local search (we even use this today), adding SASS styles loading, and consuming OpenAPI specs to generate full API documentation pages. And it couldn’t be easier to roll your own.

- https://github.com/rohit-gohri/redocusaurus

Vale is an OSS tool that you can use as a "prose linter" with many of these rules. You can also write your own rules. Together with a spellchecker its a good replacement for proprietary tools like grammarly.

- https://github.com/errata-ai/vale

> Write in US English with US grammar. (Tested in British.yml.)

heh, that was funny but it turns out the file is a list of British words checked using Vale, which I just learned existed: https://github.com/errata-ai/vale#readme (MIT)

Also, another TIL is that the "e" version of gray is British https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/.vale... I had previously erroneously assumed they were just one of those quirks of English (which, I guess is still true but it is less random than I thought)

Off the top of my head, Vale and Acrolinx.

I have recently thought of feeding the suggestions from Vale (https://vale.sh/) into an LLM along with your writing. Currently I just simply ask an LLM to take what I wrote and put it into a more "active voice". I then manually edit my writing to make it more "active" if I choose -- I do not just publish LLM generated content unaltered.

Note: I did not ask an LLM for this comment.

vale to spell check and enforce writing style on my articles