chore: Release uploads artifact + RELEASING.md instructions (#433)

The workflow would need to be tested on the next release

Author: Kamirus

.github/workflows/release.yml

@@ -6,14 +6,27 @@ on:
     - published
   workflow_dispatch:
 
+permissions:
+  contents: write
+
 jobs:
   publish:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v3
-    - name: Publish
+    - name: Install
+      run: npm ci
+    - name: Package
+      id: package
       run: |
-        npm install
-        npm run publish
+        npx vsce package
+        echo "vsix=$(ls *.vsix)" >> "$GITHUB_OUTPUT"
+    - name: Publish
+      run: npx vsce publish --packagePath ${{ steps.package.outputs.vsix }}
       env:
         VSCE_PAT: ${{ secrets.VSCE_PAT }}
+    - name: Upload Release Asset
+      if: github.event_name == 'release'
+      run: gh release upload ${{ github.event.release.tag_name }} ${{ steps.package.outputs.vsix }}
+      env:
+        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

RELEASING.md

@@ -0,0 +1,15 @@
+# Releasing
+
+1. Update the bundled Motoko compiler: `npm i motoko@latest`
+2. Update `version` in `package.json`
+3. Commit and push to `master`
+4. Go to [GitHub Releases](https://github.com/caffeinelabs/vscode-motoko/releases) and draft a new release
+5. Create a new tag matching the version (e.g. `v0.21.0`)
+6. Leave the title blank so it's automatically populated with the version
+7. Generate release notes by clicking **Generate release notes**
+8. Click **Publish release**
+
+The [release workflow](.github/workflows/release.yml) will automatically:
+- Build the `.vsix` extension
+- Publish it to the VS Code Marketplace
+- Upload the `.vsix` as a release asset

package.json

@@ -2,7 +2,7 @@
     "name": "vscode-motoko",
     "displayName": "Motoko",
     "description": "Motoko language support",
-    "version": "0.21.0",
+    "version": "0.22.0",
     "publisher": "dfinity-foundation",
     "repository": "https://github.com/caffeinelabs/vscode-motoko",
     "engines": {