Add ec2 docs

Author: fredericbarthelet

README.md

@@ -102,8 +102,8 @@ Once a budget is hit, all resources within the construct on which this budget ha
 
 While `CostLimit` aspect can be applied on any node type, budget capabilities are only enabled on a subset of resources listed below. Cost generated by resources other than the one specified are not taken into account with regards to the budget limit. Only resources listed below are disabled once budget is reached.
 
-- ✅ `AWS::Lambda::Function`
-- ⏳ `AWS::EC2::Instance`
+- [✅ `AWS::Lambda::Function`](./docs/lambda.md)
+- [🚧 `AWS::EC2::Instance`](./docs/ec2.md)
 
 ### Lifecycle
 

docs/ec2.md

@@ -0,0 +1,48 @@
+# AWS Lambda
+
+> [!NOTE]
+> Max AWS EC2 instances spending rate with default AWS Quotas: $63 / hour / region
+
+## Usage
+
+You can simply replace your `Instance` native CDK import statement by this package exported `Instance` construct.
+
+```diff
+- import { Instance } from "@aws-cdk-lib/aws-ec2";
++ import { Instance } from "@revant-io/cdk-cost-limit";
+```
+
+The `Instance` construct accepts the exact same props at the AWS CDK Instance construct (refer to the [AWS CDK dedicated documentation](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ec2.Instance.html) for a list of all supported props). In addition to those native props, it accepts the following:
+
+| Name    | Type   | Description                                                                 |
+| ------- | ------ | --------------------------------------------------------------------------- |
+| budget? | number | The monthly budget limit for this specific resource, specified in $US cents |
+
+_Example_
+
+```typescript
+import { Instance } from "@revant-io/cdk-cost-limit";
+
+const fn = new Instance(this, "MyInstance", {
+  /* The budget allocated to this resource in $US cents.
+   * For exemple, if you want to set a budget of $1,00
+   * for a specific Lambda function, you should used
+   * a value of 100 for this prop.
+   */
+  budget: 100,
+});
+```
+
+By default, if budget is not specified, an unlimited budget (Instance normal behavior) is used.
+
+## How it works
+
+Todo
+
+## Manually restore
+
+In order to reset `Instance` that have been disabled by a budget, you need to start the instance.
+
+```sh
+aws ec2 start-instances --instance-ids <instanceId>
+```