From 3d39e0209a826865aabd8bab1cabb9a84c0a5d54 Mon Sep 17 00:00:00 2001
From: tarikgul <tariksnow37@gmail.com>
Date: Fri, 26 Jan 2024 11:50:09 -0500
Subject: [PATCH] docs: add `RELEASE.md`

---
 RELEASE.md | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 RELEASE.md

diff --git a/RELEASE.md b/RELEASE.md
new file mode 100644
index 00000000..a733d95a
--- /dev/null
+++ b/RELEASE.md
@@ -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.