diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index 9a5bd45..ccd884a 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -9,6 +9,10 @@ on:
     branches:
       - main
 
+permissions:
+  contents: read
+  pull-requests: write
+
 jobs:
   build_and_deploy_job:
     if: github.event_name == 'push' || (github.event_name == 'pull_request' && github.event.action != 'closed')
diff --git a/src/components/button/button.stories.ts b/src/components/button/button.stories.ts
index b1c39a4..d9696c5 100644
--- a/src/components/button/button.stories.ts
+++ b/src/components/button/button.stories.ts
@@ -8,7 +8,7 @@ export default {
 } satisfies Meta;
 
 export const Default: StoryObj = {
-  render: ({ Variant }) => html`<cx-button variant=${Variant}>I'm a button</cx-button>`,
+  render: ({ Variant }) => html`<cx-button variant=${Variant}>I'm a button in a PR</cx-button>`,
   argTypes: {
     Variant: { control: 'radio', options: ['primary', 'secondary'] },
   },
diff --git a/src/components/button/button.ts b/src/components/button/button.ts
index def6fd5..093ce0d 100644
--- a/src/components/button/button.ts
+++ b/src/components/button/button.ts
@@ -24,6 +24,10 @@ export class Button extends LitElement {
     }
   `;
 
+  /**
+   * @description Controls the appearance of the button
+   * @default "primary"
+   */
   @property()
   variant: 'primary' | 'secondary' = 'primary';