Here is how a proposal should be structured for easier reviewing and discussions
- Proposal and rationale behind, in the form of a
proposal file
. This file should explain what change it is proposing and provide a justification for the change. - An example and its dedicated subfolder in the
examples/
folder
We could do all our work in a branch of the main bids-specification repository. We would be able to see how our proposed changes affected the current version of the specification by opening a pull request.
However, there are quite a few changes to make, and quite a lot of conversation to have around each of them, so our proposed way of working is to break up the individual changes into manageable chunks.
BEP028 has a dedicated branch on the bids-specification repository.
Contributing to the BEP028 requires creating a pull request to be merged to this branch
There will then be some wrangling to make the one big pull request to the bids-specification. We'll cross that bridge when we come to it! ✨