Add script files to generate release notes.

Author: rupeshjSFDC

docs/history.md

@@ -0,0 +1,24 @@
+import os
+
+import click
+
+
+@click.command()
+@click.option("--prev", required=True, help="Previous version tag")
+@click.option("--next", required=True, help="Next version tag")
+def main(prev, next):
+    os.system("git fetch")
+    cmd = (
+        'gh api --method POST -H "Accept: application/vnd.github.v3+json" '
+        + "/repos/SFDO-Tooling/CumulusCI/releases/generate-notes"
+        + f" -f tag_name='{next}' "
+        + "-f target_commitish='main' "
+        + f"-f previous_tag_name='{prev}' --jq .body "
+        + "| pandoc -f gfm -t rst"
+    )
+    print(cmd)
+    os.system(cmd)
+
+
+if __name__ == "__main__":
+    main()

utility/generate-release-notes.py

@@ -0,0 +1,15 @@
+"""
+Update the history file.
+"""
+from pathlib import Path
+
+START_MARKER = "<!-- latest-start -->"
+STOP_MARKER = "<!-- latest-stop -->"
+
+history = Path("docs/history.md").read_text()
+latest = Path("changelog.md").read_text()
+updated = history.replace(f"{STOP_MARKER}\n\n", "").replace(
+    f"{START_MARKER}\n\n", f"{START_MARKER}\n\n{latest}\n\n{STOP_MARKER}\n\n"
+)
+
+Path("docs/history.md").write_text(updated)