How to contribute a specification proposal
The specification proper is written in AsciiDoc, a mark-up language geared towards good source readability as well as nice rendering.
The recommended approach to contribute to the spec is via GitHub pull requests. This is an extremely useful tool to review and comment proposals.
Some basic info on pull requests.
When doing a pull request, make sure to:
- rebase your work off the latest master
- name your topic branch by the issue number (like BVAL-42)
- rebase your work rather than merge, non linear histories are annoying
- respect the style (coding, number of columns per line etc)
Recommended tools to edit the AsciiDoc specification
Refer to the tips on asciidoctor.org for AsciiDoc tooling including live previews.