fix release docs-update step + restore stripped version refs

The release workflow's "Update documentation with released version" step
re-reads release.properties to get TAG and VERSION, but release:perform
deletes that file as part of its cleanup. When the step runs, grep returns
nothing, VERSION is empty, and the sed commands strip versions from README
and the bug-report template with no replacement. Commit 8ca2836 ("docs:
update version references to ", trailing space) shows it firing during the
v0.4.1 release in April.

Step 1 already exports `version` to $GITHUB_OUTPUT before release:perform
runs, so the docs step can consume it directly. Switch to that, add an
empty-value guard so a future regression fails loudly, and pass the value
in via `env:` per GitHub Actions injection-prevention guidance.

Also restore the version refs that the prior failure left empty:
- README Gradle dependency line: 1.0.0-SNAPSHOT
- bug-report template Library version example: 1.0.0

Author: jcputney

.github/ISSUE_TEMPLATE/bug_report.md

@@ -8,7 +8,7 @@ labels: bug
 Clear, concise description of the bug.
 
 ## Environment
-- Library version: (e.g., )
+- Library version: (e.g., 1.0.0)
 - Java version: (e.g., 17.0.11)
 - OS: (e.g., macOS 14, Ubuntu 22.04, Windows 11)
 - File access backend: (ZipFileAccess, LocalFileAccess, S3 v1/v2, custom)

.github/workflows/release.yml

@@ -51,9 +51,16 @@ jobs:
           MAVEN_GPG_PASSPHRASE: ${{ secrets.MAVEN_GPG_PASSPHRASE }}
 
       - name: Update documentation with released version
+        env:
+          # Consume the version exported by the publish step. release.properties
+          # is unreliable here because release:perform deletes it during cleanup.
+          VERSION: ${{ steps.publish.outputs.version }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          TAG=$(grep 'scm.tag=' release.properties | cut -d'=' -f2)
-          VERSION=${TAG#v}
+          if [[ -z "$VERSION" ]]; then
+            echo "::error::Empty version output from publish step; refusing to strip doc versions"
+            exit 1
+          fi
 
           # Update Maven dependency version (only the line after the library artifactId)
           sed -i '/<artifactId>elearning-module-parser<\/artifactId>/{n;s/<version>.*<\/version>/<version>'"${VERSION}"'<\/version>/}' README.md
@@ -67,8 +74,6 @@ jobs:
           git add README.md .github/ISSUE_TEMPLATE/bug_report.md
           git commit -m "docs: update version references to ${VERSION}"
           git push
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
   # Attestations and the GitHub Release SBOM upload run in a separate job so
   # the OIDC token (id-token: write) and attestations: write permission are

README.md

@@ -49,14 +49,14 @@ The library is published to Maven Central.
 <dependency>
    <groupId>dev.jcputney</groupId>
    <artifactId>elearning-module-parser</artifactId>
-   <version></version>
+   <version>1.0.0-SNAPSHOT</version>
 </dependency>
 ```
 
 ### Gradle (Kotlin DSL)
 
 ```kotlin
-implementation("dev.jcputney:elearning-module-parser:")
+implementation("dev.jcputney:elearning-module-parser:1.0.0-SNAPSHOT")
 ```
 
 ### Optional dependencies