Write Better with Vale: Automate Your Style Guides and Lint Prose Like You Lint Code

— —

Brian P. Hogan Susannah Davidson

Write Better with Vale

Automate Your Style Guides and Lint Prose Like You Lint Code

Brian P. Hogan, Susannah Davidson

$64.99

Paperback

Not in-store but you can order this
How long will it take?

Availability Information

We source books from suppliers in Australia and overseas. For books we don't currently have in stock, the time it takes to get them from our suppliers can vary widely - from a few days to a few months - so we check each book with each supplier to determine the expected time it will take to be supplied to us.

We then advise you accordingly. If the time taken to get any book is too long for you, you can let us know and we will cancel or adjust your order, and refund as required.

To find out the anticipated arrival time for specific items prior to ordering, please contact us by phone or email:

Phone +61 2 9264 3111, or 1800 4 BOOKS (1800 4 26657) if outside Sydney:
option 1 Abbey's Bookshop (Crime, History, Science, Kids & more) • info@abbeys.com.au
option 2 Language Book Centre (ESL & Foreign Languages) • language@abbeys.com.au
option 3 Galaxy Bookshop (Sci-fi, Fantasy, Romance, Graphic Novels) • sf@galaxybooks.com.au

QTY:

English

The Pragmatic Programmers
18 December 2025

Writing & editing guides; Business communication & presentation; Technology: general issues; Automatic control engineering; Computing: general

Lint your docs like code: turn any style guide into enforceable rules with Vale and publish clear, consistent content every time.

Create consistent content that gives readers confidence with Vale, the open-source prose linter that helps you enforce your style guide automatically. Use battle-tested rules based on freely available, popular style guides, apply your brand's terms with a custom vocabulary, and integrate Vale into your text editor, Git hooks, and CI pipeline. Catch typos and inclusive-language issues before they ship, and spend your energy on shaping ideas instead of fixing copy. Whether you're a technical writer working in a docs-as-code environment, or a software engineer who occasionally writes, you'll ship clean, consistent copy every time.

When you work on a content project, keeping things consistent can feel impossible. Typos slip through, people don't follow style rules, and each contributor brings a slightly different voice. Vale helps you ensure consistency across your content.

You'll start by catching typos as you learn how Vale works through hands-on examples. Then you'll bring in community rules based on Google's and Microsoft's style guides. You'll combine overlapping styles, adjust the rules to match your needs, and start shaping the experience you want readers to have. Then you'll build your own rules from scratch and create a custom vocabulary to teach Vale to enforce your team's voice and jargon. By the end, you'll have a fully integrated, reusable style package that works in your editor, GitHub Actions, and your build systems. And while this book uses Markdown in its examples, you'll be ready to apply everything you learned to reStructuredText, AsciiDoc, and even the comments in your source code.

Vale gives you a fast, reliable, and customizable way to keep your content consistent.

What You Need:

This book uses Vale 3.12.0 or higher. You'll need a text editor like Visual Studio Code or Vim. You should be familiar with basic regular expressions, and be comfortable working with command-line tools and Markdown.

By: Brian P. Hogan
Edited by: Susannah Davidson
Imprint: The Pragmatic Programmers
Country of Publication: United States
Dimensions: Height: 234mm, Width: 190mm,
ISBN: 9798888651810
Pages: 85
Publication Date: 18 December 2025
Audience: Professional and scholarly , Undergraduate
Format: Paperback
Publisher's Status: Active

Brian P. Hogan is a technical content expert, open source software developer, educator, author, editor, and musician with more than 15 years of experience developing and leading technical documentation and developer education programs at DigitalOcean, Temporal Technologies, and Tailscale.

Reviews for Write Better with Vale: Automate Your Style Guides and Lint Prose Like You Lint Code

I’d never encountered Vale before reading this book, but I’m much better informed now. Hogan’s writing, as always, is clear, informative, and most importantly, actionable. I now plan to implement Vale both at my organization and for my personal projects.— Steve Hill, Senior Developer, Resource Guru I would recommend this book to technical writers or anyone in a documentation-heavy role who is looking to enhance their existing workflow, enforce consistent style, and improve the overall quality of their written content. It's a practical and effective guide.— Abhigna Nagaraja, Staff Software Engineer