Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
Refactor the specs into separate repositories? #750
There's value in keeping the specs in a single repository because they share a bunch of common prose and link to each other. But there would be value in putting the steps specification into the steps repository because that's where step issues are raised.
I suppose with a little more build magic, we could have the steps specification in a different repository, but still pull them all together in the build for the language spec.
A drawback could also be that whenever we reorganize the specs, we’ll have to move the issues, too (and also update references to issues). I wouldn’t oppose though.
When the subspecs reside in separate repos, we can use Git submodules to tie them together. This requires less magic. Note that submodules are fixed to a certain commit; you’ll have to get used to updating them to the latest commit and commit the containing overarching spec.