docs: improve release process (#33)

.github/workflows/node.js.yml

@@ -25,8 +25,8 @@ jobs:
           cache: 'pnpm'
       - name: install
         run: pnpm install --frozen-lockfile
-      - name: build
-        run: pnpm build
+      - name: build packages
+        run: pnpm build-packages
       - name: lint
         run: pnpm lint
       - name: test

CONTRIBUTING.md

@@ -58,7 +58,17 @@ Before submitting a PR, make sure to test your changes locally. Here's how:
 
 For everything about Nalanda's documentation, head over to the `documentation` directory.
 
-## 📝 Submitting Changes
+## Releasing
+
+1. Make sure your PRs titles are prefixed with right convention (`feat`, `docs`, `fix`, `refactor`, `test`, `perf`, `style`, `ci`, `build`).
+
+1. ensure you are in `dev` branch and do `git pull origin dev`
+
+1. Run `pnpm -r --filter scripts set-version x.y.z` to bump the version.
+
+1. Go to github and create a new release with the tag that was created in the previous step.
+
+1. Run `pnpm publish-alpha --otp=123456` or `publish-latest` to publish the packages to npm.
 
 ## ❓ Questions or Need Help?
 

scripts/set-version.ts

@@ -42,8 +42,15 @@ if (filesChanged) {
     execSync(`git push origin v${version}`);
     execSync(`git push origin HEAD --tags`);
     console.log(`Committed and tagged version ${version}.`);
+    console.log(
+      `Visit https://github.com/bangle-io/nalanda/releases/new?tag=v${version} to add release notes.`,
+    );
   } catch (error) {
-    console.error('Error committing or tagging the version:', error.message);
+    if (error instanceof Error) {
+      console.error('Error committing or tagging the version:', error.message);
+    } else {
+      throw error;
+    }
     process.exit(1);
   }
 }