-
Notifications
You must be signed in to change notification settings - Fork 11
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
66 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,66 @@ | ||
## Release Documentation | ||
|
||
The following will cover releasing the `asset-transfer-api` to both github and NPM. | ||
|
||
### Creating The Release Branch | ||
|
||
1. Ensure you are in your `main` branch. | ||
- `git pull origin main` | ||
- `git checkout -b <name>-vXX-XX-XX` | ||
|
||
2. In your new release branch update the version inside of the `package.json` to match the version we are releasing. This is super important as it will be the source of truth for updating to NPM. | ||
|
||
3. Inside of the `CHANGELOG.md`, follow the previous format of other releases, and input each commit that is being added in this current release. | ||
|
||
4. Run `yarn docs` to update the docs and ensure they are correct. | ||
|
||
5. Run: | ||
|
||
```bash | ||
$ git add . | ||
$ git commit -m 'chore(release): vXX.XX.XX' | ||
$ git push | ||
``` | ||
|
||
6. When approved merge the PR into main. | ||
|
||
### Creating the NPM release | ||
|
||
REQUIREMENTS: | ||
- You must be part of the integrations NPM team for substrate. | ||
- You must have 2FA enabled. | ||
|
||
1. Ensure your current working branch is `main`, and run the following as a sanity check. | ||
|
||
```bash | ||
$ git pull origin main | ||
$ yarn build | ||
$ yarn test | ||
``` | ||
|
||
2. Run: | ||
|
||
```bash | ||
$ yarn deploy | ||
``` | ||
NOTE: | ||
|
||
- Ensure the logging provided by NPM says the current version that is going to get released is correct before you enter your OTP. | ||
- If you are on node version 18 or below, it will ask you for your OTP in the terminal. But if you are on node 20 or greater if will redirect you to the browser to input the OTP. | ||
|
||
3. Tada! You should have now recieved a message saying the package is released. You can go to https://www.npmjs.com/package/@substrate/asset-transfer-api to double check the releases success. | ||
|
||
### Creating a Github release. | ||
|
||
1. Right after you have released the NPM package, we are going to set a tag that will match the version of the release: | ||
|
||
```bash | ||
$ git tag vXX.XX.XX | ||
$ git push origin vXX.XX.XX | ||
``` | ||
|
||
2. Once that is pushed to github, go to https://github.com/paritytech/asset-transfer-api/tags, and in the tab where the new version has now been created, click on the 2 dots all the way to the right, and press `create release`. | ||
|
||
3. Inside of `create release` you may copy the contents of the `CHANGELOG.md` for the release and input them there. For the title, just name it the version `vXX.XX.XX`. | ||
|
||
4. Click `Publish as latest`, and that will complete the release process. |