diff --git a/README.md b/README.md index b80e4ab..56c43f5 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,16 @@ **Alviss** is a scaffolding project that let's you provision and deploy production ready API:s in seconds on AWS using API Gateway and Lambda +Rationale +-------- +Configuring API Gateway and Lambda using standard IaC tools like Terraform and Cloudformation is a very finicky and time consuming experience. Even with tools that are designed for serverless applications like *AWS SAM* and *serverless framework* can be hard and time consuming. Alviss is a scaffolder that takes care of the boilerplate using best practices and leaves you to tweak the settings. Use [AWS SAM](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/what-is-sam.html) to finally deploy the project. + + +Installation +-------- +Alviss is built in Go; meaning no runtime or dependencies to install, just grab a pre-built binary from the [GitHub Releases page](https://github.com/rogerwelin/alviss/releases). You can optionally put the **alviss** binary in your `PATH` so you can run alviss from any location. + + Usage --------