Merge branch 'release' into 'main'0.5.0

chore: prepare release 0.5.0

See merge request subplot/subplot!289

1 files changed, 22 insertions, 0 deletions

diff --git a/NEWS.md b/NEWS.md
index c42174e..88a8b56 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -4,6 +4,28 @@ This file summarises the changes between released versions of Subplot and its
 associated libraries, especially with regards to changes visible to
 the user of the Subplot software.
 
+# Version 0.5.0, released 2022-09-13
+
+* The big, breaking change for this release is that Subplot now
+  expects document metadata in a separate YAML file. It was previously
+  embedded in the Markdown input file. This allows us to be more
+  strict, when parsing the metadata: we only need to support what
+  Subplot needs, not the nearly arbitrary YAML Pandoc supports. Later
+  on, it will also enable us to support multiple Markdown files as
+  input.
+
+* That change also means that we drop support for use of Subplot as a
+  Pandoc filter (the `subplot-filter` command and the `subplot filter`
+  subcommand). It doesn't make sense unless the metadata is
+  embedded in the Markdown.
+
+* We've renamed things so that we consistently call a Markdown fenced
+  code block that is marked as a data file, an "embedded file".
+  Previously we also used other names, causing unnecessary confusion.
+
+* The new home page URL is updated in all crate metadata. This means
+  crates.io will point at the new location after this release is made.
+
 # Version 0.4.3, released 2022-007-29
 
 - Bump the dependency on the `roadmap` crate to a version that depends