How to contribute a specification proposal
The specification proper is written in Docbook, an XML based documentation.
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 Docbook specification
By decreasing order of preference:
- XMLMind XML Editor
- Any XML editor
Make sure to not go beyond 80 columns per line.