Adding Globals section and DeploymentPreference definition

Author: sanathkr

versions/2016-10-31.md

@@ -30,6 +30,7 @@ In order to include objects defined by AWS SAM within a CloudFormation template,
  - [Resource types](#resource-types)
  - [Event source types](#event-source-types)
  - [Property types](#property-types)
+ - [Globals Section](#globals-section)
 
 
 ### Example: AWS SAM template
@@ -48,6 +49,24 @@ Resources:
 
 All property names in AWS SAM are **case sensitive**.
 
+### Globals Section
+Lambda functions within a SAM template tend to have shared configuration such as Runtime, Memory, VPC Settings, Environment Variables etc. Instead of duplicating this information in every function, you can write them once in the Globals section and let all Functions inhert it.
+
+Example:
+
+```
+Globals:
+  Function:
+    Runtime: nodejs6.10
+    Timeout: 180
+    Handler: index.handler
+    Environment:
+      Variables:
+        TABLE_NAME: data-table
+```
+
+Read the [Globals Guide](../docs/globals.rst) for more detailed information.
+
 ### Resource types
  - [AWS::Serverless::Function](#awsserverlessfunction)
  - [AWS::Serverless::Api](#awsserverlessapi)
@@ -77,7 +96,7 @@ Tags | Map of `string` to `string` | A map (string to string) that specifies the
 Tracing | `string` | String that specifies the function's [X-Ray tracing mode](http://docs.aws.amazon.com/lambda/latest/dg/lambda-x-ray.html). Accepted values are `Active` and `PassThrough`
 KmsKeyArn | `string` | The Amazon Resource Name (ARN) of an AWS Key Management Service (AWS KMS) key that Lambda uses to encrypt and decrypt your function's environment variables.
 DeadLetterQueue | `map` <span>&#124;</span> [DeadLetterQueue Object](#deadletterqueue-object) | Configures SNS topic or SQS queue where Lambda sends events that it can't process.
-DeploymentPreference | [DeploymentPreference Object](../docs/safe_lambda_deployments.rst) | Settings to enable Safe Lambda Deployments
+DeploymentPreference | [DeploymentPreference Object](#deploymentpreference-object) | Settings to enable Safe Lambda Deployments. Read the [usage guide](../docs/safe_lambda_deployments.rst) for detailed information.
 AutoPublishAlias | `string` | Name of the Alias. Read [AutoPublishAlias Guide](../docs/safe_lambda_deployments.rst#instant-traffic-shifting-using-lambda-aliases) for how it works
 
 ##### Return values
@@ -487,3 +506,20 @@ DeadLetterQueue:
   Type: `SQS` or `SNS` 
   TargetArn: ARN of the SQS queue or SNS topic to use as DLQ. 
 ```
+
+#### DeploymentPreference Object
+Specifies the configurations to enable Safe Lambda Deployments. Read the [usage guide](../docs/safe_lambda_deployments.rst) for detailed information. The following shows all available properties of this object
+
+```yaml
+DeploymentPreference:
+  Enabled: true
+  Type: Linear10PercentEvery10Minutes
+  Alarms:
+    # A list of alarms that you want to monitor
+    - !Ref AliasErrorMetricGreaterThanZeroAlarm
+    - !Ref LatestVersionErrorMetricGreaterThanZeroAlarm
+  Hooks:
+    # Validation Lambda functions that are run before & after traffic shifting
+    PreTraffic: !Ref PreTrafficLambdaFunction
+    PostTraffic: !Ref PostTrafficLambdaFunction
+```