motivation

index.rst

@@ -3,19 +3,11 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Kweb - The Contrarian Web Framework
+Kweb: The Contrarian Web Framework
 ===================================
 
-Table of Contents
------------------
-
+Create fast, beautiful, efficient, powerful websites in Kotlin.
 .. toctree::
 
    intro
 
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`

intro.rst

@@ -8,18 +8,19 @@ A new paradigm for webapps
 Most websites are two pieces of tightly coupled software:
 
  * Client
-   * Runs in the browser
-   * Responsible for user interaction
-   * Typically written in JavaScript
-   * Runs in an "untrusted" environment
+    * Runs in the browser
+    * Responsible for user interaction
+    * Typically written in JavaScript
+    * Runs in an "untrusted" environment
 
  * Server
-   * Runs in a datacenter
-   * Responsible for
+    * Runs in a datacenter
+    * Responsible for business logic
+    * May be written in a wide variety of languages
+    * Runs in a trusted environment
 
-The first runs on the web server, the second
-runs in the web browser.  Coders work hard to try to make the website appear like a single piece
-of software to the website visitor, but this requires a lot of hidden complexity.
+The first runs on the web server, the second runs in the web browser.  Coders work hard to try to make the website
+appear like a single piece of software to the website visitor, but this requires a lot of hidden complexity.
 
 Kweb allows you to write your entire app as a single piece of software, as
 if it was running on a single computer.  It's written in `Kotlin <https://kotlinlang.org/>`_, a
@@ -37,4 +38,5 @@ Build Powerful, fast, beautiful websites, painlessly and quickly
 
 * A single unified codebase for your webapp, no artificial separation between browser and server
 * Code in Kotlin (`Why? <https://steve-yegge.blogspot.com/2017/05/why-kotlin-is-better-than-whatever-dumb.html?m=1>`_)
-* Efficient
+* Makes efficient use of WebSockets and "preloading" of instructions to the browser
+* A smooth upgrade path to Web Assembly