From d171c65618a181466226d2f34a2ac94f6f0bcc4c Mon Sep 17 00:00:00 2001
From: "Daniel A. A. Pelsmaeker" <developer@pelsmaeker.net>
Date: Wed, 29 May 2024 14:12:18 +0200
Subject: [PATCH] metaborgVersion is now required

---
 content/release/migrate/vnext.md | 20 ++++++++++++++++++++
 content/release/note/vnext.md    |  2 +-
 2 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/content/release/migrate/vnext.md b/content/release/migrate/vnext.md
index 72e0a024b..bb60581db 100644
--- a/content/release/migrate/vnext.md
+++ b/content/release/migrate/vnext.md
@@ -1,3 +1,23 @@
 # Spoofax vNext Migration Guide
 
 This is a stub for the migration guide of the upcoming version of Spoofax.
+
+## Metaborg Version in metaborg.yaml
+Before, the value of `metaborgVersion` in `metaborg.yaml` was hardcoded in Spoofax 2 to be `2.6.0-SNAPSHOT`. From now on, it is no longer hardcoded and must be explicitly specified in the `metaborg.yaml` file of a language project. For example:
+
+```yaml
+---
+id: org.metaborg:mylang:1.0.0
+name: mylang
+metaborgVersion: 2.6.0-SNAPSHOT
+# ...
+```
+
+If this is not done, the following error can occur:
+
+```
+MissingDependencyException: Language for dependency org.metaborg:org.metaborg.meta.lang.spt:2.5.20 does not exist
+```
+
+
+
diff --git a/content/release/note/vnext.md b/content/release/note/vnext.md
index a48daf634..006372788 100644
--- a/content/release/note/vnext.md
+++ b/content/release/note/vnext.md
@@ -9,4 +9,4 @@ See the corresponding [migration guide](../migrate/vnext.md) for migrating from
 ## Added
 
 ## Changes
-
+- The value of `metaborgVersion` in `metaborg.yaml` is no longer hardcoded and must be specified explicitly in the `metaborg.yaml` file of a language project. See the migration guide.