From 655856ed4aef01676f30b2ab6fe2e58e35e4f69f Mon Sep 17 00:00:00 2001
From: Sam Gammon <sam@elide.ventures>
Date: Mon, 20 May 2024 11:38:58 -0700
Subject: [PATCH] feat: pkl and compat pages

---
 Writerside/e.tree                  |  4 +++-
 Writerside/topics/Compatibility.md | 20 ++++++++++++++++++++
 Writerside/topics/Experimental.md  |  1 +
 Writerside/topics/Pkl.md           |  3 +++
 4 files changed, 27 insertions(+), 1 deletion(-)
 create mode 100644 Writerside/topics/Compatibility.md
 create mode 100644 Writerside/topics/Pkl.md

diff --git a/Writerside/e.tree b/Writerside/e.tree
index 189d8bd..8975099 100644
--- a/Writerside/e.tree
+++ b/Writerside/e.tree
@@ -11,6 +11,7 @@
     <toc-element topic="Installation.md"/>
     <toc-element topic="GettingStarted.md"/>
     <toc-element topic="Language-Guides.topic">
+        <toc-element topic="Compatibility.md"/>
         <toc-element topic="Polyglot.md">
             <toc-element topic="101-Environment.md"/>
             <toc-element topic="101-Filesystem.md"/>
@@ -24,6 +25,7 @@
         </toc-element>
         <toc-element toc-title="Guides by Language">
             <toc-element topic="JavaScript.md">
+                <toc-element topic="TypeScript.md"/>
                 <toc-element topic="Node-API.md">
                     <toc-element topic="node-assert.md"/>
                     <toc-element toc-title="Async Hooks" />
@@ -66,9 +68,9 @@
                     <toc-element toc-title="Web Streams API" />
                 </toc-element>
             </toc-element>
-            <toc-element topic="TypeScript.md"/>
             <toc-element topic="Python.md"/>
             <toc-element topic="Ruby.md"/>
+            <toc-element topic="Pkl.md"/>
             <toc-element topic="Experimental.md"/>
         </toc-element>
         <toc-element topic="Container-Images.md"/>
diff --git a/Writerside/topics/Compatibility.md b/Writerside/topics/Compatibility.md
new file mode 100644
index 0000000..7a2714a
--- /dev/null
+++ b/Writerside/topics/Compatibility.md
@@ -0,0 +1,20 @@
+# Compatibility
+
+%product% is **alpha-quality software**, meaning it has not yet reached a level of stability where correct operation is
+guaranteed or even typical.
+
+The language engines used by %product% are based on [GraalVM](https://graalvm.org)
+[Truffle](https://www.graalvm.org/latest/graalvm-as-a-platform/language-implementation-framework/). Truffle engines
+aren't necessarily compatible by default with their corresponding regular language engines.
+
+Refer to the table below for resources regarding compatibility in each language.
+
+| Language                       | Stability                                                          | %product%'s Engine                                                      | Stock Engine                                   | Notes                                                                                                           |
+|--------------------------------|--------------------------------------------------------------------|-------------------------------------------------------------------------|------------------------------------------------|-----------------------------------------------------------------------------------------------------------------|
+| [JavaScript](JavaScript.md)    | ![Beta](https://img.shields.io/badge/-beta-purple)                 | [GraalJs](https://github.com/oracle/graaljs)                            | [V8](https://v8.dev/)                          | ECMA2023-compatible. [Node API](Node-API.md) compat pending.                                                    |
+| [WebAssembly](Experimental.md) | ![Alpha](https://img.shields.io/badge/-alpha-blue)                 | [GraalWasm](https://github.com/oracle/graal/blob/master/wasm/README.md) | [V8](https://v8.dev/)                          |                                                                                                                 |
+| [Python](Python.md)            | ![Alpha](https://img.shields.io/badge/-alpha-blue)                 | [GraalPython](https://github.com/oracle/graalpython)                    | [CPython](https://github.com/python/cpython)   | Roughly **~48% compatible** with PyPI top 500. See [here](https://www.graalvm.org/python/compatibility/).       |
+| [Ruby](Ruby.md)                | ![Alpha](https://img.shields.io/badge/-alpha-blue)                 | [TruffleRuby](https://github.com/oracle/truffleruby)                    | [MRI](https://rvm.io/interpreters/ruby)        | Passes ~**97% of `ruby/spec`**. See [here](https://www.graalvm.org/latest/reference-manual/ruby/Compatibility/) |
+| [LLVM](Experimental.md)        | ![Experimental](https://img.shields.io/badge/-experimental-orange) | [Sulong](https://github.com/oracle/graal/tree/master/sulong)            | [LLVM Runtime](https://llvm.org/)              |                                                                                                                 |
+| [TypesScript](TypeScript.md)   | ![Experimental](https://img.shields.io/badge/-experimental-orange) | [TSC](https://github.com/microsoft/typescript)                          | [TSC](https://github.com/microsoft/typescript) |                                                                                                                 |
+| [Pkl](Pkl.md)                  | ![Experimental](https://img.shields.io/badge/-experimental-orange) | [Apple Pkl](https://github.com/apple/pkl)                               | [Apple Pkl](https://github.com/apple/pkl)      |                                                                                                                 |
diff --git a/Writerside/topics/Experimental.md b/Writerside/topics/Experimental.md
index 6ff2436..d889c15 100644
--- a/Writerside/topics/Experimental.md
+++ b/Writerside/topics/Experimental.md
@@ -8,6 +8,7 @@ construction upstream, as part of [GraalVM](https://graalvm.org).
 | JVM         | [Espresso](https://www.graalvm.org/latest/reference-manual/java-on-truffle/) | ![Experimental](https://img.shields.io/badge/-experimental-orange) **Linux amd64 only.** |
 | LLVM        | [Sulong](https://www.graalvm.org/latest/reference-manual/llvm/)              | ![Experimental](https://img.shields.io/badge/-experimental-orange)                       |
 | WebAssembly | [GraalWasm](https://www.graalvm.org/latest/reference-manual/wasm/)           | ![Experimental](https://img.shields.io/badge/-experimental-orange)                       |
+| Pkl         | [Apple Pkl](https://github.com/apple/pkl)                                    | ![Experimental](https://img.shields.io/badge/-experimental-orange)                       |
 
 Several experimental engines support multiple dialects.
 
diff --git a/Writerside/topics/Pkl.md b/Writerside/topics/Pkl.md
new file mode 100644
index 0000000..2fc9b15
--- /dev/null
+++ b/Writerside/topics/Pkl.md
@@ -0,0 +1,3 @@
+# Pkl
+
+Coming soon.