docs: Add frontend branching strategy ADR#94
Conversation
a6124e6 to
7e13eb9
Compare
b9c5038 to
bf84e2f
Compare
| ----------------------------------- | ||
|
|
||
| A repository's main branch will be published semantically to NPM with on an | ||
| "alpha" prerelease tag, with a monotonically incremented version number. For |
There was a problem hiding this comment.
I'm not married to "alpha". It could be "main", or "next", or anything else, really (as long as every frontend app repo follows the same pattern, of course).
bf84e2f to
3ea2cbb
Compare
|
So just to be sure I get this right @arbrandes
Now, how or were are we going to track what's compatible with which edx-platform version? |
That's exactly what I'm proposing, yes. (In addition to publishing from main using a prerelease tag such as the one we have now.)
Good question. It begins with this ADR. Prior to each release we'll announce which versions of things will work with that release. So the announcement would be the source of truth. One potential de facto source of truth could be frontend-template-site. Whatever is in its package.json is what that release expects. (We would be tagging frontend-template-site with And obviously Tutor itself, while downstream, would be de facto documentation. |
This ADR introduces the concept of "main is unstable" to frontend repositories, from whence alpha packages will be published semantically to NPM.
Parent issue: #96