Autogenerate Markdown file with release checklist links

GitHub removed the feature allowing Markdown issue templates without front
matter to be used in the `template` query argument.  Adding front matter
would cause the template to appear in the user-facing issue template
chooser, degrading the issue UX a bit.  However, we can still autofill the
issue body by including it inline in the `body` query argument.  Move
maintainer templates to a separate directory and autogenerate a README.md
that embeds them.

Signed-off-by: Benjamin Gilbert <bgilbert@cs.cmu.edu>

Author: bgilbert

.github/maintainer/README.md

@@ -0,0 +1,5 @@
+<!-- Generated by mkmaintainer.py; do not edit -->
+
+## Maintainer issue templates
+
+- [Release checklist](https://github.com/openslide/openslide-java/issues/new?title=Release+X.Y.Z&body=%23+OpenSlide+Java+release+process%0A%0A-+%5B+%5D+Update+%60CHANGELOG.md%60+and+version+in+%60pom.xml%60%0A-+%5B+%5D+Create+and+push+signed+tag%0A-+%5B+%5D+Verify+that+GitHub+Actions+created+a+%5BGitHub+release%5D%28https%3A%2F%2Fgithub.com%2Fopenslide%2Fopenslide-java%2Freleases%29+with+release+notes+and+a+JAR%0A-+%5B+%5D+Update+website%3A+%60_data%2Freleases.yaml%60%2C+%60_includes%2Fnews.md%60%0A-+%5B+%5D+Send+mail+to+-announce+and+-users%0A-+%5B+%5D+Post+to+%5Bforum.image.sc%5D%28https%3A%2F%2Fforum.image.sc%2Fc%2Fannouncements%2F10%29&labels=release)

.github/maintainer/mkmaintainer.py

@@ -0,0 +1,25 @@
+#!/usr/bin/python
+
+from pathlib import Path
+from urllib.parse import urlencode
+
+import yaml
+
+dir = Path(__file__).parent
+with open(dir / 'README.md', 'w') as fh:
+    fh.write('<!-- Generated by mkmaintainer.py; do not edit -->\n\n')
+    fh.write('## Maintainer issue templates\n\n')
+    for path in sorted(dir.iterdir()):
+        if path.name == 'README.md' or path.suffix != '.md':
+            continue
+        _, front, body = path.read_text().split('---\n', 2)
+        info = yaml.safe_load(front)
+        args = urlencode(
+            {
+                'title': info['title'],
+                'body': body.strip(),
+                'labels': ','.join(info.get('labels', [])),
+            }
+        )
+        url = f"https://github.com/{info['repo']}/issues/new?{args}"
+        fh.write(f"- [{info['link-text']}]({url})\n")

.github/ISSUE_TEMPLATE/release.md .github/maintainer/release.md.github/ISSUE_TEMPLATE/release.md renamed to .github/maintainer/release.md

@@ -1,3 +1,10 @@
+---
+link-text: Release checklist
+repo: openslide/openslide-java
+title: Release X.Y.Z
+labels: [release]
+---
+
 # OpenSlide Java release process
 
 - [ ] Update `CHANGELOG.md` and version in `pom.xml`

.pre-commit-config.yaml

@@ -26,3 +26,12 @@ repos:
     hooks:
       - id: check-hooks-apply
       - id: check-useless-excludes
+
+  - repo: local
+    hooks:
+      - id: mkmaintainer
+        name: Sync maintainer issue templates
+        entry: .github/maintainer/mkmaintainer.py
+        files: .github/maintainer/
+        language: python
+        additional_dependencies: [PyYAML]