Merge branch 'master' into 0.2.3

Author: joshuafcole

README.md

@@ -6,61 +6,35 @@
 
 Eve is a programming language and IDE based on years of research into building a human-first programming platform. You can play with Eve online here: [play.witheve.com](http://play.witheve.com/).
 
-[![Play With Eve](http://programming.witheve.com/images/eve.png)](http://play.witheve.com/)
+[![Play With Eve](http://witheve.github.io/assets/images/editor.png)](http://play.witheve.com/#/examples/flappy.eve)
 
-## Installation
-
-### From Source
-
-You'll need a recent [node.js](https://nodejs.org) for your platform. Download the Eve source either by cloning this repository:
+## How to use Eve
 
+Install [Node](https://nodejs.org/en/download/) for your platform, then install Eve:
 
 ```
-git clone https://github.com/witheve/Eve.git
+npm install -g witheve
 ```
 
-or you can [download](https://github.com/witheve/Eve/archive/master.zip) the Eve source directly. To build and run Eve, run the following commands in the root Eve directory:
+Use the `eve` command to run a `*.eve` program:
 
 ```
-npm install
-npm start
+eve myProgram.eve
 ```
 
-Then open `http://localhost:8080/` in your browser.
-
-### From npm
-
-Alternatively, you can download Eve directly from npm with the following command:
+For more on running Eve, see the [documentation](http://docs.witheve.com/handbook/running/).
 
-```
-npm install witheve
-```
-
-### From Docker
+You can alternatively install Eve from source ([mac](http://docs.witheve.com/handbook/mac/), [windows](http://docs.witheve.com/handbook/windows/), [linux](http://docs.witheve.com/handbook/linux/)), or with [Docker](http://docs.witheve.com/handbook/docker/). 
 
-First, [download](https://www.docker.com/products/docker) and install Docker for your platform. To download and install the Eve container, run the following command:
-
-```
-docker run -p 8080:8080 witheve/eve
-```
-
-## How to use Eve
+## Learning Eve
 
 You can learn about Eve with the following resources:
 
-- [Play with Eve in your browser](http://play.witheve.com/) (use Chrome for best results)
+- [Read the Quick Start Tutorial](http://play.witheve.com/) (use Chrome for best results)
 - [Syntax Quick Reference](https://witheve.github.io/assets/docs/SyntaxReference.pdf)
-- [Eve Language Handbook (draft)](http://docs.witheve.com)
-
-*Please let us know what kind of documents would be the most helpful as you begin your journey with Eve*. We want our documentation to be a highlight of the Eve experience, so any suggestions are greatly appreciated.
-
-### Running Eve Programs in Server Mode
+- [Language Handbook (draft)](http://docs.witheve.com)
 
-By default, Eve executes on the client browser. To instead execute your program on the server, launch Eve with the `--server` flag:   
-
-```
-npm start -- --server
-```
+Also, the [mailing list archive](https://groups.google.com/forum/#!forum/eve-talk) is a good resource for help and inspiration. In particular, the [Puzzles & Paradoxes series](https://groups.google.com/forum/#!searchin/eve-talk/Puzzles$20$26$20Paradoxes%7Csort:date) answers a lot of questions beginners face about the Eve langauge.
 
 ## Get Involved
 
@@ -75,17 +49,15 @@ The Eve community is small but constantly growing, and everyone is welcome!
 
 ### How to Contribute
 
-The best way to contribute right now is to write Eve code and report your experiences. Let us know what kind of programs you’re trying to write, what barriers you are facing in writing code (both mental and technological), and any errors you encounter along the way. Also, let us know what you love! What features are your favorite?
-
-Another way to really help us is to host your `*.eve` files on Github, so we can get Eve recognized as an official language in the eyes of Github. Be sure to also send us a link to your repo!
+The best way to contribute right now is to write Eve code and report your experiences. [Let us know](https://groups.google.com/forum/#!forum/eve-talk) what kind of programs you’re trying to write, what barriers you are facing in writing code (both mental and technological), and any errors you encounter along the way.
 
 ### How to File an Issue
 
 Please file any issues in this repository. Before you file an issue, please take a look to see if the issue already exists. When you file an issue, please include:
 
 1. The steps needed to reproduce the bug
 2. Your operating system and browser.
-3. If applicable, the .*eve file that causes the bug.
+3. If applicable, the `.*eve` file that causes the bug.
 
 ## License
 

examples/tic-tac-toe.eve

@@ -10,7 +10,7 @@ Tic-Tac-Toe is a classic game played by two players, "X" and "O", who take turns
 
 ### Game settings
 
-To begin, we initialize the board. We commit an object named @board to hold our global state and create a set of #cells. These #cells will keep track of the moves players have made. Common connect-N games (a generalized tic-tac-toe for any `NxN` grid) are scored along 4 axes (horizontal, vertical, the diagonal, and the anti-diagonal). We group cells together along each axis up front to make scoring easier later.
+To begin, we initialize the board. We commit a `#board` record to hold our global state and create a set of `#cell`s, which will keep track of the moves players have made. Common connect-N games (a generalized tic-tac-toe for any `NxN` grid) are scored along 4 axes (horizontal, vertical, the diagonal, and the anti-diagonal). We group cells together along each axis up front to make scoring easier later.
 
 The game board is square, with a given size. It contains size ^ 2 cells,
 each with a row and column index.

src/runtime/server.ts

@@ -308,7 +308,7 @@ export function run() {
   // If the port is already in use, display an error message
   process.on('uncaughtException', function handleAddressInUse(err) {
     if(err.errno === 'EADDRINUSE') {
-      console.log(`ERROR: Eve couldn't start because port ${config.port} is already in use.\n\nYou can select a different port for Eve using the "port" argument.\nFor example:\n\n> npm start -- --port 1234`);
+      console.log(`ERROR: Eve couldn't start because port ${config.port} is already in use.\n\nYou can select a different port for Eve using the "port" argument.\nFor example:\n\n> eve --port 1234`);
     } else {
       throw err;
     }