fix: Add issues permission and fallback for doc-suggestions workflow

- Add issues: write permission (was missing)
- Add fallback to log URLs if issue creation is blocked by org settings
- Workflow now succeeds even if issue creation fails

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: critesjosh

.github/workflows/doc-suggestions.yml

@@ -16,7 +16,7 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: write
-      pull-requests: write
+      issues: write
 
     steps:
       - name: Checkout dev-rel
@@ -84,8 +84,9 @@ jobs:
           git commit -m "docs: Add documentation suggestions for ${DATE}"
           git push -u origin "$BRANCH_NAME"
 
-          # Create issue with link to create PR (org settings prevent Actions from creating PRs directly)
-          gh issue create \
+          # Try to create issue with link to create PR
+          # Falls back to just logging URLs if org settings block issue creation
+          if gh issue create \
             --title "📚 Documentation suggestions ready for ${DATE}" \
             --body "## Documentation Update Suggestions
 
@@ -103,4 +104,12 @@ jobs:
           4. Open Claude Code in aztec-packages and paste the suggestion
 
           ---
-          🤖 Generated by the doc-suggestions tool"
+          🤖 Generated by the doc-suggestions tool"; then
+            echo "Issue created successfully"
+          else
+            echo "::warning::Could not create issue (org may block this). Branch pushed successfully."
+            echo ""
+            echo "📚 Documentation suggestions ready for ${DATE}"
+            echo "Branch: ${BRANCH_NAME}"
+            echo "Create PR: https://github.com/${{ github.repository }}/compare/main...${BRANCH_NAME}?expand=1"
+          fi