Release version 5.0.0

Author: mkrnr

.github/RELEASE_DRAFT_FILTER.lua

@@ -1,24 +1,36 @@
--- Strip everything after the first section
--- (i.e. the notes for the last release).
+-- Keep only the blocks that belong to the first level-1 section (release),
+-- but drop the level-1 header itself.
 
-release_count = 0
+local in_first_release = false
+local past_first_release = false
 
 return {
   {
-    Header = function (elem)
-      if elem.level == 2 then
-        release_count = release_count + 1
+    Header = function(h)
+      if h.level == 1 then
+        if not in_first_release and not past_first_release then
+          -- Enter the first release; drop this H1 itself
+          in_first_release = true
+          return {}
+        else
+          -- Any subsequent H1 ends the first release; drop it and everything after
+          past_first_release = true
+          return {}
+        end
       end
-      if elem.level < 3 or release_count > 1 then
+      -- For subheaders inside the first release, keep them; otherwise drop
+      if past_first_release or not in_first_release then
         return {}
       end
-      return elem
+      return h
     end,
-    Block = function (elem)
-      if release_count > 1 then
+
+    Block = function(b)
+      -- Drop everything before the first H1 and after the next H1
+      if past_first_release or not in_first_release then
         return {}
       end
-      return elem
+      return b
     end,
   }
-}
+}

.github/RELEASE_DRAFT_TEMPLATE.md

@@ -1,9 +1,18 @@
-# Plover $version$
+# Plover v$version$
 
-> **Warning**: Version 5 updates the graphical interface library from PyQt5 to PySide6 which requires graphical plugins to be migrated.
+## ⚠️ Important Notice
 
-## Installation Guide
+Version 5 updates the graphical interface library from PyQt5 to PySide6, which means graphical plugins need to be migrated.
+Please check the [Unsupported Plugins List](https://github.com/openstenoproject/plover_plugins_registry/blob/master/unsupported.json) before installing this version.
 
-Read the [Installation Guide](https://github.com/openstenoproject/plover/wiki/Installation-Guide) to see which file you need to download.
+## Installation
+
+To install Plover, please follow the [Installation Guide](https://plover.wiki/index.php/Installation_Guide) on our wiki.  
+
+## Changelog
 
 $body$
+
+## Release History
+
+For a detailed list of changes in this and all previous versions, see [NEWS.md](https://github.com/openstenoproject/plover/blob/v$version$/NEWS.md).

.github/workflows/ci/helpers.sh

@@ -152,7 +152,7 @@ EOF
   run pandoc --from=gfm --to=gfm \
     --lua-filter=.github/RELEASE_DRAFT_FILTER.lua \
     --template=.github/RELEASE_DRAFT_TEMPLATE.md \
-    --shift-heading-level-by=2 --wrap=none \
+    --shift-heading-level-by=1 --wrap=none \
     --variable="version:$RELEASE_VERSION" \
     --output=notes.md \
     "$notes_body" || die

NEWS.md

@@ -1,3 +1,18 @@
+# v5.0.0 (2025-09-10)
+
+
+## Features
+
+No significant changes.
+
+## Bugfixes
+
+No significant changes.
+
+## API
+
+No significant changes.
+
 # v5.0.0rc1 (2025-09-02)
 
 

doc/conf.py

@@ -6,7 +6,7 @@
 copyright = "Open Steno Project"
 author = copyright
 
-release = "5.0.0rc1"
+release = "5.0.0"
 version = release
 
 # -- General configuration ---------------------------------------------------

plover/__init__.py

@@ -13,7 +13,7 @@
     # want to translate anyway.
     _ = lambda s: s
 
-__version__ = "5.0.0rc1"
+__version__ = "5.0.0"
 __copyright__ = "(C) Open Steno Project"
 __url__ = "http://www.openstenoproject.org/"
 __download_url__ = "http://www.openstenoproject.org/plover"