Updated top-level README file for ag-grid. Added github-banner.png and github-grid-demo.png referenced in README files

Author: mkoretskyi

README.md

@@ -1,56 +1,118 @@
 
-ag-Grid
-==============
+![alt text](./github-banner.png "Logo Title Text 1")
+
 [![CDNJS](https://img.shields.io/cdnjs/v/ag-grid.svg)](https://cdnjs.com/libraries/ag-grid)
 [![npm](https://img.shields.io/npm/dm/ag-grid.svg)](https://www.npmjs.com/package/ag-grid)
 [![npm](https://img.shields.io/npm/dt/ag-grid.svg)](https://www.npmjs.com/package/ag-grid)
 
-"ag" stands for AGnostic
+ag-Grid
+------
+
+ag-Grid is a fully-featured and highly customizable JavaScript data grid.
+It delivers [outstanding performance](https://www.ag-grid.com/example.php?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github#/performance/1), has no 3rd party dependencies and [integrates smoothly with all major JavaScript frameworks](https://www.ag-grid.com/javascript-grid-getting-started?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github). Here's how our grid looks like with multiple filters and grouping enabled:
 
-This project contains all of the core projects for ag-Grid.
+![alt text](./github-grid-demo.jpg "Logo Title Text 1")
 
-Please refer to each of the respective sub-projects for more information on each:
 
-[ag-grid: Core ag-Grid Project](./packages/ag-grid/README.md)
-[ag-grid-enterprise: ag-Grid Enterprise Project](./packages/ag-grid-enterprise/README.md)
-[ag-grid-angular: ag-Grid Angular Project](./packages/ag-grid-angular/README.md)
-[ag-grid-react: ag-Grid React Project](./packages/ag-grid-react/README.md)
-[ag-grid-vue: ag-Grid Vue Project](./packages/ag-grid-vue/README.md)
-[ag-grid-aurelia: ag-Grid Aurelia Project](./packages/ag-grid-aurelia/README.md)
+Features
+--------------
 
-For full working examples (including Polymer and Webcomponents) please refer to [www.ag-grid.com](https://www.ag-grid.com) 
+Besides the standard set of features you'd expect from any grid:
 
-For example projects, please refer to the following repositories:
+* Column Interactions (resize, reorder, and pin columns)
+* Pagination
+* Sorting
+* Row Selection
 
-[ag-Grid Angular CLI Example](https://github.com/ag-grid/ag-grid-angular-cli-example/)
-[ag-Grid React Example](https://github.com/ag-grid/ag-grid-react-example/)
-[ag-Grid Vue Example](https://github.com/ag-grid/ag-grid-vue-example/)
-[ag-Grid Aurelia Example](https://github.com/ag-grid/ag-grid-aurelia-example/)
+Here are some of the features that make ag-Grid stand out:
 
-Asking Questions
-==============
+* Grouping / Aggregation*
+* Custom Filtering
+* In-place Cell Editing
+* Records Lazy Loading *
+* Server-Side Records Operations *
+* Live Stream Updates
+* Hierarchical Data Support & Tree View *
+* Customizable Appearance
+* Customizable Cell Contents
+* Excel-like Pivoting *
+* State Persistence
+* Keyboard navigation
+* Data Export to CSV
+* Data Export to Excel *
+* Row Reordering
+* Copy / Paste 
+* Column Spanning
+* Pinned Rows
+* Full Width Rows
 
-+Please do not use GitHub issues to ask questions. Ask questions in the
-+[Stack Overflow ag-grid channel](https://stackoverflow.com/questions/tagged/ag-grid).
+\* The features marked with an asterisk are available in the [enterprise version](https://www.ag-grid.com/license-pricing.php?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github) only.
 
-Contributing
-==============
+Check out [developers documentation](https://www.ag-grid.com/documentation-main/documentation.php?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github) for a complete list of features or visit [our official docs](https://www.ag-grid.com/features-overview?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github) for tutorials and feature demos. 
+
+Looking for a framework specific solution?
+--------------
+* [Get Started with AngularJS](https://www.ag-grid.com/best-angularjs-data-grid?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github)
+* [Get Started with Angular](https://www.ag-grid.com/angular-getting-started?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github)
+* [Get Started with React](https://www.ag-grid.com/react-getting-started?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github)
+* [Get Started with Vue](https://www.ag-grid.com/vue-getting-started?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github)
+* [Get Started with WebComponents](https://www.ag-grid.com/best-web-component-data-grid?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github)
+
+Usage Overview
+--------------
+
+#### Install dependencies
+
+    $ npm i --save ag-grid
+
+### Add a placeholder to HTML
+
+    <div id="myGrid" style="height: 150px;width: 600px" class="ag-theme-balham"></div>
 
-ag-Grid is not looking for contributors. It is not intended to be developed by an online community.
-However suggestion on change and raising bugs are appreciated.
 
-If you are doing a Pull Request:
-- Make your code changes in `src/` files only, don't update dist files
-- Discard all changes to `dist/`
-- Create Pull Request
+#### Import the grid and styles
 
-For large changes:
-- Make your doc changes in project [ag-grid-docs](https://github.com/ag-grid/ag-grid-docs), a feature is not complete unless it's documented!
-- Do manual end to end testing off all examples in documentation
+    import {Grid} from "ag-grid/main";
 
-PR's on new features **are not** generally accepted. 
+    import "ag-grid/dist/styles/ag-grid.css";
+    import "ag-grid/dist/styles/ag-theme-balham.css";
 
-PR's on small bug fixes **are** generally accepted.
+### Set configuration
+
+    const gridOptions = {
+    	columnDefs: [
+    		{headerName: 'Make', field: 'make'},
+    		{headerName: 'Model', field: 'model'},
+    		{headerName: 'Price', field: 'price'}
+    	],
+    	rowData: [
+    		{make: 'Toyota', model: 'Celica', price: 35000},
+    		{make: 'Ford', model: 'Mondeo', price: 32000},
+    		{make: 'Porsche', model: 'Boxter', price: 72000}
+    	]
+    };
+
+### Initialize the grid
+
+    let eGridDiv = document.querySelector('#myGrid');
+    new Grid(eGridDiv, this.gridOptions);
+
+For more information on how to integrate the grid into your project see [TypeScript - Building with Webpack 2](https://www.ag-grid.com/ag-grid-typescript-webpack-2?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github).
+
+Issue Reporting
+----------
+If you have found a bug, please report them at this repository `issues` section. If you're using Enterprise version please use the private ticketing system to do that. For more information on support check out our [dedicated page](https://www.ag-grid.com/support.php?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github).
+
+
+Asking Questions
+-------------
+
+Look for similar problems on [StackOverflow](https://stackoverflow.com/questions/tagged/ag-grid) using the `ag-grid` tag. If nothing seems related, post a new message there. Do not use GitHub issues to ask questions.
+
+Contributing
+------------
+ag-Grid is developed by a team of co-located developers in London. If you want to join the team check out our [jobs listing](https://www.ag-grid.com/ag-grid-jobs-board?utm_source=ag-grid-readme&utm_medium=repository&utm_campaign=github) or send your application to [email protected].
 
-If a PR for a large request is submitted, the typical action is the author will take influence from the
-code to implement the feature, either in ag-grid or [ag-grid-enterprise](https://github.com/ag-grid/ag-grid-enterprise).
+License
+------------------
+This project is licensed under the MIT license. See the [LICENSE file](./LICENSE.txt) for more info.