motivation

index.rst

@@ -3,8 +3,8 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to Kweb's documentation!
-================================
+Kweb - The Contrarian Web Framework
+===================================
 
 Table of Contents
 -----------------

intro.rst

@@ -1,7 +1,23 @@
-Motivation
-==========
+============
+Introduction
+============
+
+A new paradigm for webapps
+--------------------------
+
+Most websites are two pieces of tightly coupled software:
 
-Most websites are two pieces of software.  The first runs on the web server, the second
+ * Client
+   * Runs in the browser
+   * Responsible for user interaction
+   * Typically written in JavaScript
+   * Runs in an "untrusted" environment
+
+ * Server
+   * Runs in a datacenter
+   * Responsible for
+
+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.
 
@@ -16,8 +32,9 @@ locally to the server.
 Through a clever set of optimizations, Kweb avoids unnecessary delays waiting for server roundtrips,
 and minimizes network latency through use of WebSockets.
 
-Key Features
-============
+Build Powerful, fast, beautiful websites, painlessly and quickly
+----------------------------------------------------------------
 
-* A single unified codebase for your webapp, no server/browser split
-* Code in Kotlin `Why Kotlin? <https://steve-yegge.blogspot.com/2017/05/why-kotlin-is-better-than-whatever-dumb.html?m=1>`_
+* 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