Improve catalog navigation and contributions

Author: akullpp

.github/pull_request_template.md

@@ -1,6 +1,15 @@
+## Suggestion type
+
+- [ ] Project
+- [ ] Resource
+
+## Checklist
+
+- [ ] I searched the list and existing issues for duplicates.
 - [ ] I changed `README_SOURCE.md`, not the generated `README.md`.
 - [ ] This pull request contains one suggestion.
-- [ ] Java is a primary API, runtime, target or first-class integration.
-- [ ] I used the canonical GitHub repository when one exists.
-- [ ] The concise, neutral description explains the distinguishing value and ends with punctuation.
-- [ ] Commercial or restrictive licensing is disclosed where applicable.
+- [ ] The suggestion is relevant to Java or the JVM and fits its chosen category.
+- [ ] I used the canonical project or resource link.
+- [ ] The suggestion is current and maintained.
+- [ ] The concise, neutral description explains its distinguishing value and ends with punctuation.
+- [ ] Licensing is clear and any restrictive terms are disclosed where applicable.

.github/workflows/update-readme.yml

@@ -1,9 +1,12 @@
+# SPDX-License-Identifier: MIT
+
 name: Update README
 
 on:
   pull_request:
     paths:
       - "README_SOURCE.md"
+      - "README.md"
       - "CONTRIBUTING.md"
       - ".github/pull_request_template.md"
       - ".github/workflows/update-readme.yml"
@@ -27,14 +30,25 @@ permissions:
 
 concurrency:
   group: update-readme-${{ github.ref }}
-  cancel-in-progress: false
+  cancel-in-progress: true
 
 jobs:
   validate:
     if: github.event_name == 'pull_request'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - name: Reject direct README changes
+        env:
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        run: |
+          if ! git diff --quiet "$BASE_SHA" "$HEAD_SHA" -- README.md; then
+            echo "::error file=README.md::README.md is generated. Edit README_SOURCE.md instead."
+            exit 1
+          fi
       - uses: actions/setup-java@v5
         with:
           distribution: temurin
@@ -79,8 +93,8 @@ jobs:
           java scripts/GenerateReadme.java generate README_SOURCE.md README.md .cache/github-stats.tsv "${args[@]}" --branch "$GITHUB_REF_NAME"
       - name: Commit README
         run: |
-          git config --local user.email "action@github.com"
-          git config --local user.name "GitHub Action"
+          git config --local user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
           git add README.md
           if git diff --staged --quiet; then
             echo "README is already current"

.gitignore

@@ -2,3 +2,5 @@
 .vscode/
 .tmp/
 .cache/
+.DS_Store
+*.class

CONTRIBUTING.md

@@ -31,6 +31,26 @@ Search existing entries and issues before submitting. Self-promotion is
 reviewed carefully but is welcome when the project meets the same criteria.
 Use one pull request per project.
 
+## Suggest a Resource
+
+Add one resource under the best group in [`README_SOURCE.md`](README_SOURCE.md):
+
+```markdown
+- [Resource Name](https://canonical.example)
+```
+
+An optional description may follow the link:
+
+```markdown
+- [Resource Name](https://canonical.example) - A concise, neutral description ending with punctuation.
+```
+
+Resources include books, podcasts, people, communities, related lists and
+websites. They must be current, relevant to Java or the JVM, use a canonical
+HTTPS link, fit the chosen group and use English where prose is involved.
+Search for duplicates and submit one resource per pull request. Contributors
+do not need to run the generator.
+
 ## Maintainer Notes
 
 Most entries point directly to one GitHub repository. For an umbrella project
@@ -43,5 +63,13 @@ homepage and append maintainer-only metadata:
 
 Use at least two canonical repositories. A repository may belong to only one
 entry. The generator sums their stars, uses their most recent push for activity
-and rejects malformed metadata, duplicate repository use and archived
+and shows a license only when every repository reports the same SPDX license.
+It rejects malformed metadata, duplicate repository use and archived
 repositories.
+
+## License
+
+Catalog and documentation contributions are licensed under
+[CC BY-SA 4.0](LICENSE). Automation code and configuration are licensed under
+the [MIT License](LICENSE-CODE). By contributing, you agree that your changes
+are available under the applicable license.