ci: Improve release notes in release.yaml

Author: mikeschinkel

.github/workflows/release.yml

@@ -7,6 +7,10 @@ on:
         description: 'Version tag (e.g., v0.1.1)'
         required: true
         type: string
+      description:
+        description: 'Release description (optional - provide context about this release)'
+        required: false
+        type: string
 
 env:
   GO_VERSION: '1.25'
@@ -105,47 +109,43 @@ jobs:
       - name: Generate release notes
         id: release_notes
         run: |
+          # Get repository name from GitHub context
+          REPO_NAME="${{ github.event.repository.name }}"
+          REPO_URL="https://github.com/${{ github.repository }}"
+
           # Get the previous tag
           PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
 
-          if [ -z "$PREV_TAG" ]; then
-            # First release
-            echo "notes<<EOF" >> $GITHUB_OUTPUT
-            echo "## DotErr ${{ inputs.version }}" >> $GITHUB_OUTPUT
+          echo "notes<<EOF" >> $GITHUB_OUTPUT
+          echo "## ${REPO_NAME} ${{ inputs.version }}" >> $GITHUB_OUTPUT
+          echo "" >> $GITHUB_OUTPUT
+
+          # Add user-provided description if present
+          if [ -n "${{ inputs.description }}" ]; then
+            echo "${{ inputs.description }}" >> $GITHUB_OUTPUT
             echo "" >> $GITHUB_OUTPUT
-            echo "Initial release of go-doterr - embeddable, zero-dependency error composition for Go." >> $GITHUB_OUTPUT
+          fi
+
+          if [ -z "$PREV_TAG" ]; then
+            # First release - show all commits from beginning
+            echo "### Commits" >> $GITHUB_OUTPUT
             echo "" >> $GITHUB_OUTPUT
-            echo "### Features" >> $GITHUB_OUTPUT
-            echo "- Structured error metadata with key-value pairs" >> $GITHUB_OUTPUT
-            echo "- Sentinel error support for type-safe error identification" >> $GITHUB_OUTPUT
-            echo "- Layered error composition with cause chains" >> $GITHUB_OUTPUT
-            echo "- Error enrichment with \`WithErr()\` for same-function metadata" >> $GITHUB_OUTPUT
-            echo "- Multi-error bundling with \`CombineErrs()\`" >> $GITHUB_OUTPUT
-            echo "- Zero external dependencies - pure Go stdlib" >> $GITHUB_OUTPUT
-            echo "- Three usage patterns: embed source file, dot-import, or normal import" >> $GITHUB_OUTPUT
-            echo "- Cross-package error detection for embedded instances" >> $GITHUB_OUTPUT
+            git log --pretty=format:"- [**%h**](${REPO_URL}/commit/%H) - %s (%an, %ar)" >> $GITHUB_OUTPUT
             echo "" >> $GITHUB_OUTPUT
-            echo "### Usage Patterns" >> $GITHUB_OUTPUT
-            echo "1. **Embed the source file** (recommended) - copy \`doterr.go\` directly into your package" >> $GITHUB_OUTPUT
-            echo "2. **Dot-import** - \`import . \"github.com/mikeschinkel/go-doterr\"\`" >> $GITHUB_OUTPUT
-            echo "3. **Normal import** - \`import \"github.com/mikeschinkel/go-doterr\"\`" >> $GITHUB_OUTPUT
             echo "" >> $GITHUB_OUTPUT
-            echo "See [README.md](README.md) for full documentation and examples." >> $GITHUB_OUTPUT
-            echo "EOF" >> $GITHUB_OUTPUT
+            echo "See [README.md](README.md) for documentation and usage." >> $GITHUB_OUTPUT
           else
-            # Subsequent releases - generate from commits
-            echo "notes<<EOF" >> $GITHUB_OUTPUT
-            echo "## DotErr ${{ inputs.version }}" >> $GITHUB_OUTPUT
-            echo "" >> $GITHUB_OUTPUT
+            # Subsequent releases - show commits since last tag
             echo "### Changes since $PREV_TAG" >> $GITHUB_OUTPUT
             echo "" >> $GITHUB_OUTPUT
-            git log ${PREV_TAG}..HEAD --pretty=format:"- %s" >> $GITHUB_OUTPUT
+            git log ${PREV_TAG}..HEAD --pretty=format:"- [**%h**](${REPO_URL}/commit/%H) - %s (%an, %ar)" >> $GITHUB_OUTPUT
             echo "" >> $GITHUB_OUTPUT
             echo "" >> $GITHUB_OUTPUT
-            echo "**Full Changelog**: https://github.com/mikeschinkel/go-doterr/compare/${PREV_TAG}...${{ inputs.version }}" >> $GITHUB_OUTPUT
-            echo "EOF" >> $GITHUB_OUTPUT
+            echo "**Full Changelog**: ${REPO_URL}/compare/${PREV_TAG}...${{ inputs.version }}" >> $GITHUB_OUTPUT
           fi
 
+          echo "EOF" >> $GITHUB_OUTPUT
+
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with: