See README.html (asciidoc source in README.txt) for instructions and notes about building the spec. Unfortunately gitlab won't render HTML or Asciidoc in its web view page, so this README.md is of limited utility.