Improve GitHub Release notes with PR details

Changes:
- Pass PR number through job outputs to release creation step
- Fetch PR title and body from GitHub API
- Use PR content as release notes (no more fake CHANGELOG reference)
- Add installation instructions using pipx (recommended method)
- Include links to package (PyPI/TestPyPI), PR, and documentation
- Update RELEASE.md to mention PR body becomes release notes

Release notes now include:
- PR title and description
- Installation: pipx install quarto-batch-convert
- Links to package, PR, and docs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: kompre

.github/RELEASE.md

@@ -38,7 +38,12 @@ After merge:
 - Package is built and tested
 - Published to PyPI or TestPyPI
 - Git tag created (e.g., `v2025.9.0`)
-- GitHub Release created
+- GitHub Release created with:
+  - PR title and body as release notes
+  - Installation instructions (`pipx install quarto-batch-convert`)
+  - Links to package, PR, and documentation
+
+**Tip**: Write a clear PR description - it will become your release notes!
 
 ## Example: Patch Release to PyPI
 

.github/workflows/release.yml

@@ -16,6 +16,7 @@ jobs:
     outputs:
       should-release: ${{ steps.check.outputs.release }}
       is-test: ${{ steps.check.outputs.test }}
+      pr-number: ${{ steps.check.outputs.pr_number }}
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -59,6 +60,9 @@ jobs:
             echo "test=false" >> $GITHUB_OUTPUT
           fi
 
+          # Export PR number for later jobs
+          echo "pr_number=$PR_NUMBER" >> $GITHUB_OUTPUT
+
   build:
     needs: check-release-label
     if: needs.check-release-label.outputs.should-release == 'true'
@@ -186,15 +190,38 @@ jobs:
         env:
           GH_TOKEN: ${{ github.token }}
           VERSION: ${{ needs.build.outputs.version }}
+          PR_NUMBER: ${{ needs.check-release-label.outputs.pr-number }}
         run: |
-          RELEASE_TYPE="${{ needs.check-release-label.outputs.is-test == 'true' && 'test' || 'production' }}"
+          RELEASE_TYPE="${{ needs.check-release-label.outputs.is-test == 'true' && 'TestPyPI' || 'PyPI' }}"
+          PACKAGE_URL="${{ needs.check-release-label.outputs.is-test == 'true' && 'https://test.pypi.org/project/quarto-batch-convert' || 'https://pypi.org/project/quarto-batch-convert' }}"
 
-          gh release create "v${VERSION}" \
-            --title "v${VERSION}" \
-            --notes "Release v${VERSION} (${RELEASE_TYPE})
+          # Fetch PR details
+          PR_TITLE=$(gh pr view $PR_NUMBER --json title --jq '.title')
+          PR_BODY=$(gh pr view $PR_NUMBER --json body --jq '.body')
+          PR_URL="https://github.com/${{ github.repository }}/pull/$PR_NUMBER"
+
+          # Build release notes
+          RELEASE_NOTES="## ${PR_TITLE}
+
+          ${PR_BODY}
+
+          ---
 
-            Published from PR #${{ github.event.pull_request.number }}
+          ## Installation
 
-            See [CHANGELOG](https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md) for details." \
+          \`\`\`bash
+          pipx install quarto-batch-convert
+          \`\`\`
+
+          ## Links
+
+          - 📦 Package: [${RELEASE_TYPE}](${PACKAGE_URL})
+          - 🔗 Pull Request: [#${PR_NUMBER}](${PR_URL})
+          - 📚 Documentation: [README](https://github.com/${{ github.repository }}/blob/main/README.md)
+          "
+
+          gh release create "v${VERSION}" \
+            --title "v${VERSION}" \
+            --notes "$RELEASE_NOTES" \
             --draft=false \
             --prerelease=${{ needs.check-release-label.outputs.is-test == 'true' }}