Add examples to README

Author: RomanHotsiy

README.md

@@ -22,11 +22,11 @@ plugins:
   - serverless-plugin-typescript
 ```
 
-## Example
+## Configure
 
 See [example folder](example) for a minimal example.
 
-## `tsconfig.json`
+### `tsconfig.json`
 
 The default `tsconfig.json` file used by the plugin looks like this:
 
@@ -43,14 +43,78 @@ The default `tsconfig.json` file used by the plugin looks like this:
 }
 ```
 
-> Note 1: The `outDir` option cannot be overwritten. 
+> Note 1: The `outDir` and `rootDir` options cannot be overwritten.
 
 > Note 2: Don't confuse the [`tsconfig.json`](tsconfig.json) in this repository with the one mentioned above.
 
-## Including extra files
+### Including extra files
 
 All files from `package/include` will be included in the final build file. See [Exclude/Include](https://serverless.com/framework/docs/providers/aws/guide/packaging#exclude--include)
 
+
+## Usage
+
+### Automatic compilation
+
+The normal Serverless deploy procedure will automatically compile with Typescript:
+
+- Create the Serverless project with `serverless create -t aws-nodejs`
+- Install Serverless Typescript as above
+- Deploy with `serverless deploy`
+
+### Usage with serverless-offline
+
+The plugin integrates very well with [serverless-offline][https://github.com/dherault/serverless-offline] to
+simulate AWS Lambda and AWS API Gateway locally.
+
+Add the plugins to your `serverless.yml` file and make sure that `serverless-plugin-typescript`
+precedes `serverless-offline` as the order is important:
+```yaml
+  plugins:
+    ...
+    - serverless-plugin-typescript
+    ...
+    - serverless-offline
+    ...
+```
+
+Run `serverless offline` or `serverless offline start` to start the Lambda/API simulation.
+
+In comparison to `serverless offline`, the `start` command will fire an `init` and a `end` lifecycle hook which is needed for `serverless-offline` and e.g. `serverless-dynamodb-local` to switch off resources (see below)
+
+#### serverless-dynamodb-local
+
+Configure your service the same as mentioned above, but additionally add the `serverless-dynamodb-local`
+plugin as follows:
+```yaml
+  plugins:
+    - serverless-plugin-typescript
+    - serverless-dynamodb-local
+    - serverless-offline
+```
+
+Run `serverless offline start`.
+
+#### Other useful options
+
+You can reduce the clutter generated by `serverless-offline` with `--dontPrintOutput` and
+disable timeouts with `--noTimeout`.
+
+### Run a function locally
+
+To run your compiled functions locally you can:
+
+```bash
+$ serverless invoke local --function <function-name>
+```
+
+Options are:
+
+- `--function` or `-f` (required) is the name of the function to run
+- `--watch` - recompile and run a function locally on source changes
+- `--path` or `-p` (optional) path to JSON or YAML file holding input data
+- `--data` or `-d` (optional) input data
+
 ## Help & Community [![Slack Status](https://slack.graph.cool/badge.svg)](https://slack.graph.cool)
 
 Join our [Slack community](http://slack.graph.cool/) if you run into issues or have questions. We love talking to you!