This repository is meant to serve as a starting point for creating and maintaining your own Vale-compatible style guide. It includes a (fairly) complete implementation of the 18F Content Guide, including example rules for all of Vale's extension points and a unit test suite using Cucumber, yamllint, and Travis CI.

You can install yamllint through Homebrew:

$ brew install yamllint

To install Cucumber on OSX, run:

gem update --system
gem install rspec --no-ri --no-rdoc
gem install watir-webdriver --no-ri --no-rdoc
gem install cucumber --no-ri --no-rdoc
gem install aruba

/src

The YAML-based rule implementations that make up our style (in this case, 18F).

/fixtures

The individual unit tests. Each directory should be named after a rule found in /src and include its own .vale.ini file 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.

To check the style guide, run the following commands:

• yamllint src
• `cucumber'