serverless/docs/README.md
Philipp Muens 7311d3c89a Add documentation for awsCompileApigEvents plugin
Fix some minor typos and format issues alongside.
2016-06-15 12:25:44 +02:00

69 lines
3.8 KiB
Markdown

# Documentation
This docs section will include documentation relevant to understand how Serverless works.
You may want to start with the ["Your first service"](/docs/tutorials/your-first-service.md) tutorial to create, deploy,
invoke and remove your very first Serverless service!
If you're interested to take a look behind the scenes you might take a look at the [concepts](/docs/concepts) of
Serverless to understand the how Serverless is architected and works.
After that you should take a look at the different [plugins](/docs/plugins) which are used to deliver the functionality
Serverless provides (such as service creation, deployment, removal, function invocation etc.).
## Table of contents
- Concepts
- [services](/docs/concepts/services.md) - Understanding Serverless services
- [serverless.yaml](/docs/concepts/serverless-yaml.md) - A look at the `serverless.yaml` file
- [serverless.env.yaml](/docs/concepts/serverless-env-yaml.md) - A look at the `serverless.env.yaml` file
- [event sources](/docs/concepts/event-sources.md) - Understanding different types of event sources
- [plugins](/docs/concepts/plugins.md) - How plugins work
- Tutorials
- [Your first service](/docs/tutorials/your-first-service.md) - Create, deploy, invoke and remove your first service
- [Event sources](/docs/tutorials/event-sources.md) - Learn how you can extend your services functionality with event
sources
- Plugins
- Core plugins
- [create](/docs/plugins/core/create.md) - Creates a new Serverless service
- [deploy](/docs/plugins/core/deploy.md) - Deploy your resources to your provider
- [invoke](/docs/plugins/core/invoke.md) - Invoke your function
- [remove](/docs/plugins/core/remove.md) - Remove a deployed service
- AWS plugins
- [awsCompileFunctions](/docs/plugins/aws/awsCompileFunctions.md) - Compiles the functions to CloudFormation resources
- [awsCompileS3Events](/docs/plugins/aws/awsCompileS3Events.md) - Compiles the S3 events to CloudFormation resources
- [awsCompileScheduledEvents](/docs/plugins/aws/awsCompileScheduledEvents.md) - Compiles the Scheduled events to
CloudFormation resources
- [awsCompileApigEvents](/docs/plugins/aws/awsCompileApigEvents.md) - Compiles API Gateway events to CloudFormation
resources
- [awsDeploy](/docs/plugins/aws/awsDeploy.md) - Deploys the Serverless service to AWS
- [awsInvoke](/docs/plugins/aws/awsInvoke.md) - Invokes a AWS lambda function
- [awsRemove](/docs/plugins/aws/awsRemove.md) - Removes the service with all it's resources from AWS
## FAQ
> Where do I start when I want to write apps with Serverless?
You should take a look at the [tutorials](/docs/tutorials) where you will find different guides which will help you
with your first application (there's also a ["Your first service"](/docs/tutorials/your-first-service.md) tutorial).
> I want to integrate provider X. How does this work?
You can implement your provider of choice with he help of plugins. Start by reading the [plugin concept](/docs/concepts/plugins.md)
to get an overview how plugins work. After that you might want to take a look at the [awsDeploy](/docs/plugins/aws/awsDeploy.md)
plugin which will explain to you how the AWS provider is implemented / works.
We'd recommend to take a look at the different sources of the [plugins](/lib/plugins) as they show implementation
details and best practices which will help you integrate your provider easily.
> How does Serverless work?
The [concepts](/docs/concepts) folder in the docs will help you understand how Serverless works.
You might want to read it in this order:
1. [Services](/docs/concepts/services.md)
2. [serverless.yaml](/docs/concepts/serverless-yaml.md)
3. [serverless.env.yaml](/docs/concepts/serverless-env-yaml.md)
4. [Event Sources](/docs/concepts/event-sources.md)
5. [Plugins](/docs/concepts/plugins.md)