diff --git a/.github/workflows/linting.yml b/.github/workflows/linting.yml
index 60113cd2..31a5baf5 100644
--- a/.github/workflows/linting.yml
+++ b/.github/workflows/linting.yml
@@ -5,6 +5,9 @@ on:
 jobs:
   prose:
     runs-on: ubuntu-22.04 # See https://github.com/errata-ai/vale-action/issues/128 before upgrading
+    permissions:
+      contents: read
+      pull-requests: write
     steps:
     - name: Checkout
       uses: actions/checkout@v4
@@ -24,6 +27,7 @@ jobs:
       with:
         # Please keep version in sync with the version in .gitpod.Dockerfile for a consistent experience
         version: 3.7.1
+        files: docs/
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}