diff --git a/docs/news/unreleased/ostree-ref-handling.md b/docs/news/unreleased/ostree-ref-handling.md
new file mode 100644
index 000000000..84ca55d23
--- /dev/null
+++ b/docs/news/unreleased/ostree-ref-handling.md
@@ -0,0 +1,3 @@
+# Improve OSTree Repository URL and Ref parsing
+
+If the OSTree Repository URL did not end in a `/` the parsing would fail with a less-than-useful error message.  This has been fixed. Error messages for different failure cases have also been improved.