From 5b8392432099135deb07a78bd7a582ac777e711a Mon Sep 17 00:00:00 2001
From: Joost Kaptein <joost@compositional-it.com>
Date: Fri, 9 Aug 2024 15:06:04 +0100
Subject: [PATCH] Add known issues page for dotnet paket restore error when
 starting server

---
 docs/knownIssues.md | 17 +++++++++++++++++
 mkdocs.yml          |  1 +
 2 files changed, 18 insertions(+)
 create mode 100644 docs/knownIssues.md

diff --git a/docs/knownIssues.md b/docs/knownIssues.md
new file mode 100644
index 00000000..1687c313
--- /dev/null
+++ b/docs/knownIssues.md
@@ -0,0 +1,17 @@
+# Known Issues
+
+This page contains a (hopefully short) list of higher impact bugs that affect the SAFE template. It is not our intention to make an exhaustive list here; for all issues, check [GitHub](https://github.com/SAFE-Stack/SAFE-template/issues).
+
+## Server not starting: error: "dotnet paket restore" exited with code -532462766 
+
+.NET SDK 8.0.300 introduced a bug that caused the Server startup to fail with a paket error (`"dotnet paket restore" exited with code -532462766`). This has been resolved in SDK version 8.0.303.
+
+If for some reason you can not use a newer SDK version, pin the SDK version using`global.json`:
+
+```
+{
+    "sdk": {
+    "version": "8.0.206"
+    }
+}
+```
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 630c7711..e06068da 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -136,6 +136,7 @@ nav:
       - SAFE-Compatible UI Components: "awesome-safe-components.md"
       - Learning: "learning.md"
       - Creating a SAFE Stack App from Scratch: "safe-from-scratch.md"
+  - Known Issues: "knownIssues.md"
   - News: "news.md"
   - Support: "support.md"
   - Testimonials: "testimonials.md"