docs: much doc work, many page

Writerside/c.list

@@ -5,4 +5,5 @@
     <category id="tutorialSeries" name="Continue this series" order="1" />
     <category id="referenceDocs" name="Reference documentation" order="2"/>
     <category id="wrs" name="Writerside documentation" order="3"/>
+    <category id="gettingStarted" name="Getting Started with %product%" order="4" />
 </categories>

Writerside/cfg/buildprofiles.xml

@@ -33,4 +33,15 @@
             <noindex-content>false</noindex-content>
         </variables>
     </build-profile>
+
+    <icons>
+        <shared-src>icons</shared-src>
+    </icons>
+
+    <footer>
+        <social type="linkedin" href="https://www.linkedin.com/company/elidecloud">%product% on LinkedIn</social>
+        <social type="twitter" href="https://twitter.com/elide_dev">%product% on Twitter</social>
+        <link href="https://elide.dev">Website</link>
+        <link href="https://github.com/elide-dev">%product% on GitHub</link>
+    </footer>
 </buildprofiles>

Writerside/cfg/glossary.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE terms SYSTEM "https://resources.jetbrains.com/writerside/1.0/glossary.dtd">
+<terms>
+    <term name="GUI">Graphical User Interface</term>
+    <term name="HTTP">Hypertext Transfer Protocol</term>
+</terms>

Writerside/e.tree

@@ -43,7 +43,7 @@
                 <toc-element toc-title="TLS/SSL" />
                 <toc-element toc-title="TTY" />
                 <toc-element toc-title="UDP/Datagram" />
-                <toc-element toc-title="URL" />
+                <toc-element topic="node-url.md"/>
                 <toc-element toc-title="Utilities" />
                 <toc-element toc-title="V8" />
                 <toc-element toc-title="VM" />
@@ -82,6 +82,7 @@
     <toc-element topic="Architecture.md">
         <toc-element topic="Execution.md"/>
         <toc-element topic="Security.md"/>
+        <toc-element topic="Performance.md"/>
         <toc-element toc-title="Embedded Engines">
             <toc-element toc-title="GraalJs" href="https://github.com/oracle/graaljs" />
             <toc-element toc-title="GraalWasm" href="https://github.com/oracle/graal/blob/master/wasm/README.md" />
@@ -96,6 +97,11 @@
             <toc-element toc-title="Kotlin" href="https://kotlin-lang.org" />
         </toc-element>
     </toc-element>
+    <toc-element toc-title="Release Notes">
+        <toc-element toc-title="1.0.0-alpha9" href="https://github.com/elide-dev/elide/releases/tag/1.0.0-alpha9" />
+        <toc-element toc-title="1.0.0-alpha8" href="https://github.com/elide-dev/elide/releases/tag/1.0.0-alpha8" />
+        <toc-element toc-title="1.0.0-alpha7" href="https://github.com/elide-dev/elide/releases/tag/1.0.0-alpha7" />
+    </toc-element>
     <toc-element toc-title="Legal &amp; Licensing">
         <toc-element toc-title="Terms of Use" />
         <toc-element toc-title="Privacy Policy" />

Writerside/redirection-rules.xml

@@ -1,45 +1,4 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE rules SYSTEM "https://resources.jetbrains.com/writerside/1.0/redirection-rules.dtd">
 <rules>
-    <!-- format is as follows
-    <rule id="<unique id>">
-        <accepts>page.html</accepts>
-    </rule>
-    -->
-    <rule id="34671e9e">
-        <description>Created after removal of "Server Starter" from Elide</description>
-        <accepts>Server-Starter.html</accepts>
-    </rule>
-    <rule id="65b69b0">
-        <description>Created after removal of "Language Guides" from Elide</description>
-        <accepts>Section-Starting-Page.html</accepts>
-    </rule>
-    <rule id="18f4cf26">
-        <description>Created after removal of "Guides by Engine" from Elide</description>
-        <accepts>Guides-by-Language.html</accepts>
-    </rule>
-    <rule id="5c5f41e5">
-        <description>Created after removal of "Code Samples" from Elide</description>
-        <accepts>Samples.html</accepts>
-    </rule>
-    <rule id="8373fb4">
-        <description>Created after removal of "Reference" from Elide</description>
-        <accepts>Reference.html</accepts>
-    </rule>
-    <rule id="1e57e77d">
-        <description>Created after removal of "Reference" from Elide</description>
-        <accepts>Reference.html</accepts>
-    </rule>
-    <rule id="5b129b60">
-        <description>Created after removal of "Starter" from Elide</description>
-        <accepts>starter.html</accepts>
-    </rule>
-    <rule id="28913f73">
-        <description>Created after removal of "Template" from Elide</description>
-        <accepts>node-template.html</accepts>
-    </rule>
-    <rule id="41ba8e48">
-        <description>Created after removal of "Debugger" from Elide</description>
-        <accepts>node-debugger.html</accepts>
-    </rule>
 </rules>

Writerside/topics/Architecture.md

@@ -1,11 +1,18 @@
 # Architecture
 
-Overview articles give background information and provide context to a particular subject.
-Their goal is to explain a concept, not to teach or give instructions.
+This page gives an overview of %product%'s internal architecture. Users of %product% don't necessarily need to know
+these details; these docs are mostly for contributors, but everyone is welcome!
 
-## What is product/service/concept
+## How %product% works
 
-Provide some background and context, explain choices and alternatives.
+At a high level, %product% is a suite of libraries and applications written for the Java Virtual Machine, or
+[JVM](https://docs.oracle.com/en/java/javase/21/vm/java-virtual-machine-technology-overview.html).
+
+The JVM is an incredibly powerful runtime system, offering state-of-the-art just-in-time (JIT) compilation, memory
+safety, and a full standard library with plenty of testing and functional coverage (referred to as the
+[JDK](https://en.wikipedia.org/wiki/Java_Development_Kit), for Java Development Kit).
+
+<img src="arch-v1.svg" />
 
 ## Glossary
 

Writerside/topics/GettingStarted.md

@@ -75,3 +75,12 @@ elide ruby
 > You can use <shortcut>Ctrl+D</shortcut> or <shortcut>Ctrl+C</shortcut> twice to exit the interactive session.
 >
 {style="note"}
+
+<seealso>
+    <category ref="gettingStarted">
+        <a href="Installation.md">Installing %product%</a>
+        <a href="Polyglot.md">Polyglot 101: Thinking in Multiple Languages</a>
+        <a href="Language-Guides.topic">%product% Runtime: Language Guides</a>
+        <a href="Elide-Framework.md">%product% Framework: Using %product% from JVM</a>
+    </category>
+</seealso>

Writerside/topics/Installation.md

@@ -121,3 +121,12 @@ Certain features are not supported on macOS yet:
   At this time there are no native libs available upstream for Espresso on macOS.
   Espresso ([Java on Truffle](https://www.graalvm.org/latest/reference-manual/java-on-truffle/)) is experimental and
   this limitation is expected to change eventually.
+
+<seealso>
+    <category ref="gettingStarted">
+        <a href="GettingStarted.md">Getting Started with %product%</a>
+        <a href="Polyglot.md">Polyglot 101: Thinking in Multiple Languages</a>
+        <a href="Language-Guides.topic">%product% Runtime: Language Guides</a>
+        <a href="Elide-Framework.md">%product% Framework: Using %product% from JVM</a>
+    </category>
+</seealso>