From c057d4b8f7046c3c96e52b5598a5eec92cd4585c Mon Sep 17 00:00:00 2001
From: Joel Hawksley <joel@hawksley.org>
Date: Fri, 10 Jan 2025 16:14:16 -0700
Subject: [PATCH] add some known issues (#2193)

---
 docs/known_issues.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/known_issues.md b/docs/known_issues.md
index ce20d6abf..18183fb3f 100644
--- a/docs/known_issues.md
+++ b/docs/known_issues.md
@@ -6,6 +6,27 @@ nav_order: 9
 
 # Known issues
 
+_There remain several known issues with ViewComponent. We'd be thrilled to see you consider solutions to these thorny bugs!_
+
+## Limited i18n support
+
+ViewComponent currently only supports sidecar translation files. In some cases, it could be useful to support centralized translations using namespacing:
+
+```yml
+en:
+  view_components:
+    login_form:
+      submit: "Log in"
+    nav:
+      user_info:
+        login: "Log in"
+        logout: "Log out"
+```
+
+## Lack of Jekyll support
+
+It would be lovely if we could support rendering ViewComponents in Jekyll, as it would enable the reuse of ViewComponents across static and dynamic (Rails-based) sites.
+
 ## Issues resolved by the optional capture compatibility patch
 
 If you're experiencing issues with duplicated content or malformed HTML output, the capture compatibility patch may resolve these.