How we use Vale to enforce better writing in docs and beyond

Learn how we use Vale.sh, a programmatic writing linter, and how we use it at Spectro Cloud.

How to create a Vale linter custom rule: Manually vs. AI-prompting approach

Manually vs. AI-prompting approach

How We Use Vale to Improve Our Documentation Editing Process

Learn how Datadog’s Documentation team uses a linter to shift quality left.

Linting Documentation with Vale to Increase Quality & Consistency - includes setup steps for Xcode

Lint the documentation in your source code repository with Vale. Learn how to by reading this article from the Stream development team.

Using Vale to help engineers become better writers

From design docs to wikis, README files, inline comments in code or even articles like this one, engineers write more prose every day than they realize.

Prose linting with Vale

Learn the importance of a style guide in technical writing and how Vale ensures your content complies with it.

Introducing “Packages”

Share, sync, and extend Vale-related assets.

Writing like a pro with vale & neovim

Learn how to setup and use vale, a syntax-aware prose linter with neovim for technical writing be it personal blogs or technical documentation.

What’s the difference between Vale Server and Vale CLI?

Reducing negative and biased language in documentation

Guest post originally published on the Chronosphere blog by Chris Ward The discussions on what represents negative, biased, and diverse language continue in many open source communities…

Automate Style Checks with Jetbrains

Vale is a tool that brings code-like linting to text. You can run the tool on a file and it shows validation errors based on designated Style Guides.

How To Automate Documentation Workflow For Developers

In a world that is increasingly going remote, prioritizing good documentation and good documentation workflow is important. In this article, you’ll learn how to save hours of tedious work of writing, updating, and correcting technical documentation. In this article, you will learn how to automate your documentation workflow with Vale and GitHub Actions.

First steps with the Vale prose linter

Code linters support developers by catching errors and stylistic issues in code, such as bad formatting or keywords in the wrong places. The term comes from lint traps in dryer machines, which capture the tiny bits of fiber that separate from cloth.

Writing Articles with Vale

If you've ever done any sort of continuous long form writing, you'll eventually discover that grammar and spell checking tools break down and become more of a distraction than a benefit.

Linting your content using Vale

Most of my experience has been working with organizations that heavily invested in DITA infrastructure. During my time with IBM, we used to depend upon Acrolinx checker to be our pseudo-editor. If you have ever used Acrolinx, you know the ease of use it offers. For organizations that invest in the docs-as-code methodology, mostly startups, might find it quite an investment to indulge in Acrolinx, and that too for the TW team (budget for TW team?

Reducing Negative and Biased Language in Documentation

Taking Vale Server to the web

Vale Server now works with Gmail, GitHub, Medium, dev.to, WordPress, Confluence, … and more!

Linting the Buildkite Docs

Making the Buildkite docs more inclusive using automatic tests run on Buildkite 🛠 These linters won't fix your docs for you, but they will tell you where to fix them yourself

Documentation as code (Part 3): A Linting How To - The Vale Linter in Action

Docs-as-Code Workflow for your (API) Developer Portal

Vale & The OpenAPI Specification

A tutorial on linting your OpenAPI Specification files

Sofie's Docs Diary Vol. 16: Writing in style

Sofie would like to introduce you to the new Documentation style guide

Linting my prose with Vale

Automated Enforcement of our Style Guide

Testing your Documentation

Testing your documentation allows you to make sure it is in a consistent state. Doing this gives your users a better experience, and reduces stress around common issues as a writer. This article by...

Day 1 Lightning Talk #3 - Write the Docs Prague 2019

Vale for Spelling, Grammar, Style and Readability Linting

Check out how this developer used human language linter tool Vale to construct tests that check work for not only spelling and grammar, but usage and style, too.