Published in


Vale & The OpenAPI Specification

A tutorial on linting your OpenAPI Specification files

OpenAPI Specification files provide machine-readable (JSON or YAML) descriptions of APIs and often contain snippets of text suitable for linting.

The problem is that the target text can be hard to reach from a linting perspective. For instance, consider the following basic example:




Weekly tips, tricks, and updates about the Vale linter and its ecosystem of software.

Recommended from Medium

01coin Project Update: April 9, 2019

Ruby on Rails: Handle Errors in a DRY way

Nsure.Network Token metrics

In the pursuit of expanding the horizons of learning, Unacademy introduces courses for Chess and…

BurgerSwap just got upgraded! What’s new in the new version?

Code as Configuration in Kotlin

I created a CLI tool in Go that generates HTML Meta tags on the command line.

Will Fill Factor solves index fragmentation in SQL Server?

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Joseph Kato

Joseph Kato

An open-source software developer with interests in natural language processing, data science, and collaborative writing. More @

More from Medium

Why should we care about Semantic versioning?

Professional Pull Requests

CDK Cross-Account Pipelines Part 1

Let’s create