README update, and delete scripts dir

Author: Charles Greer

.gitignore

@@ -1 +1,2 @@
 # most of the ignored files are platform-specific
+/scripts/

README.md

@@ -2,34 +2,133 @@
 
 README for Version 1.0.0-ea2
 
-A demonstration of using MarkLogic in a three-tier application architecture.
-
-The application implements a "Question and Answer" Scenario.
+Samplestack is a demo "Question and Answer" web application that shows you how to integrate MarkLogic into a three-tier application architecture (browser, application server, and database).
 
 This release features a middle tier for the Java Enterprise Developer, implemented using Java, Spring, and Gradle.
 
-## Usage
+The project includes the following major components:
+* Web/browser front end based on Angular.js
+* Middle appserver tier implemented in Java/Spring
+* Database tier hosted on MarkLogic
+* Gradle framework to drive build and configuration of the appserver and database tiers
+* Unit tests
+
+This README covers the following topics:
+* [Prerequisites](#prerequisites)
+* [Getting Started](#getting-started)
+* [Additional Information](#additional-information)
+* [License](#license)
+
+## Prerequisites
+To configure and use this application, you need the following software:
+* Java JDK 1.7
+* MarkLogic 8 EA2 (see instructions [below](#getting-started))
+* Node.js, version 0.10 or later. See [nodejs.org](http://nodejs.org).
+* A global installation of the Node.js components [bower](http://bower.io) and [gulp](https://github.com/gulpjs/gulp). For details, see [Global Utilities](browser/README.md#global-utilities) in the [browser README](browser/README.md).
+
+The setup instructions assume you have the `git`, `javac`, `node`, `bower`, and `gulp` commands on your path.
+
+The setup procedure may install additional software, such as Gradle and Angular.
+
+## Getting Started
+Follow this procedure to set up samplestack in your environment.
+
+1. Install MarkLogic 8 Early Access. See http://ea.marklogic.com/download.
+
+2. Start MarkLogic. For details, see the [MarkLogic Installation Guide](http://docs.marklogic.com/guide/installation/procedures#id_92457).
 
-### Prerequisites
+3. Clone this repository. For example, run the following command:  
+
+    ```
+    git clone https://github.com/marklogic/marklogic-samplestack
+    ```
+4. [Set up the middle and database tiers](#setting-up-the-middle-and-database-tiers).
+
+5. [Set up the browser tier](#setting-up-the-browser-tier).
+
+
+### Setting Up the Middle and Database Tiers
+The setup assume you have MarkLogic Server running on your localhost and that your Admin user credentials are admin:admin. To change this, modify `appserver/java-spring/gradle.properties`.
+
+To install required software, configure, and build the Java middle tier and database tier of samplestack, run the following commands from the root of your cloned repository:
 
-* install MarkLogic and start it: http://ea.marklogic.com/download
-* clone this repository:
 ```bash
-git clone https://github.com/marklogic/marklogic-samplestack
+cd appserver/java-spring
+./gradlew appserver
 ```
 
-### Java/Spring implementation
+If the command fails such that you need to run it again, run the following command first to reset the database state:
 
-*See the [README in appserver/java-spring directory](appserver/java-spring/README.md)*
+```bash
+./gradlew dbteardown
+```
 
-* `cd appserver/java-spring`
-* `./gradlew appserver`
+This command will not return. When you see output of the following form, the mi ddle tier is running, and you can proceed with the browser tier setup:
+```
+Started Application in X seconds...
+>Building 85% > :bootRun
+```
+
+Successfully completing this step does the following:
+* Bootstraps the middle tier.
+* Builds the Java middle tier components.
+* Loads the database with sample data.
+* Starts up the middle tier and MarkLogic application services. 
+
+The middle tier App Server runs on port 8090 by default. Visit http://localhost:8001 if you need to administer the database.
+
+*For details, see the [README in the appserver/java-spring directory](appserver/java-spring/README.md)*
+
+### Setting Up the Browser Tier
+Use the following procedure To install required software and bootstrap the samplestack browser tier. You should already have the middle and database tiers running.
+
+For detailed instructions and troubleshooting, see the [README in the browser directory](browser/README.md).
+
+**NOTE:** If you are on Windows, you must use a Windows command shell, not Cygwin.
+
+1. Go to the browser subdirectory of the project:
 
-See README.md in appserver/java-spring for further information on the samplestack-java
+    ```bash
+    cd browser
+    ```
+2. Install the browser application.
 
-### Browser/Web Application
+    ```bash
+    npm install
+    bower install
+    ```
+3. Run the following command to build the web application, run its unit tests, and bring up the required execution environment:
+
+    ```bash
+    gulp run
+    ```
+
+When the setup successfully completes, you should see information about the available web servers running the application. The `gulp run` command does not return.
+
+### Running the Application
+Once you have the database, appserver, and browser tiers of the application configured and running, navigate to the following URL in your browser to explore the application:
+
+`http://localhost:3000/`
+
+To restart the middle tier App Server and browser tier web servers in the future, run the following commands:
+```bash
+cd appserver/java-spring
+./gradlew bootrun
+cd ../../browser
+gulp run
+```
 
-*See the [README in the browser directory](browser/README.md)*
+### Next Steps
+* Explore the application running at http://localhost:3000.
+* Explore the README in the database, appserver and browser directories for details on each tier.
+* View the database configuration by visiting http://localhost:8001.
+* Explore the database contents using Query Console. Go to http://localhost:8000/qconsole, select the samplestack database, and click Explore.
+
+## Additional Information
+For more information, see the following:
+* README for the [database](database/README.md), [appserver](appserver/java-spring/README.md), and [browser](browser/README.md) tier.
+* [Samplestack wiki](wiki).
+* [MarkLogic product documentation](http://docs-ea.marklogic.com). The credentials are available on the MarkLogic EA download page.
 
 ## License