This repository contains a Vale-compatible implementation of the Google Developer Documentation Style Guide.
The goal is to showcase how to build and maintain a full-featured style guide for Vale, including many examples of using extension points and a test suite using Cucumber, yamllint, and Travis CI.
❗ Google requires Vale >= 1.0.0. ❗
Download the latest release, copy the "Google" directory to your StylesPath, and include it in your configuration file:
# This goes in a file named either `.vale.ini` or `_vale.ini`.
StylesPath = path/to/some/directory
MinAlertLevel = warning # suggestion, warning or error
# Only Markdown and .txt files; change to whatever you're using.
[*.{md,txt}]
# List of styles to load.
BasedOnStyles = GoogleSee Usage for more information.
/Google- The YAML-based rule implementations that make up our style.
/fixtures- The individual unit tests. Each directory should be named after a rule found in
/Googleand include its own.vale.inifile that isolates its target rule. /features- The Cucumber Step Definitions we use to test our fixtures. Essentially, we use the aruba framework to test Vale's output after running it on each of our fixture directories.