chore: Add docs

Author: derek10cloud

website/docs/manifest-file.md

@@ -117,6 +117,12 @@ the fields within the __`stackql_manifest.yml`__ file are described in further d
 
 ***
 
+### <span className="docFieldHeading">`resource.if`</span>
+
+<ManifestFields.ResourceIf />
+
+***
+
 ### <span className="docFieldHeading">`resource.props`</span>
 
 <ManifestFields.ResourceProps />
@@ -390,4 +396,4 @@ resources:
         - {dest_range: "10.200.2.0/24", next_hop_ip: "10.240.0.22"}              
 ```
 
-</File>
+</File>

website/docs/manifest_fields/index.js

@@ -1,24 +1,23 @@
-export { default as Name } from './name.mdx';
-export { default as Description } from './description.mdx';
-export { default as Providers } from './providers.mdx';
-export { default as Globals } from './globals.mdx';
-export { default as GlobalName } from './globals/name.mdx';
-export { default as GlobalDescription } from './globals/description.mdx';
-export { default as GlobalValue } from './globals/value.mdx';
-export { default as Resources } from './resources.mdx';
-export { default as ResourceName } from './resources/name.mdx';
-export { default as ResourceType } from './resources/type.mdx';
-export { default as ResourceFile } from './resources/file.mdx';
-export { default as ResourceDescription } from './resources/description.mdx';
-export { default as ResourceExports } from './resources/exports.mdx';
-export { default as ResourceProps } from './resources/props.mdx';
-export { default as ResourceProtected } from './resources/protected.mdx';
-export { default as ResourceAuth } from './resources/auth.mdx';
-export { default as ResourcePropName } from './resources/props/name.mdx';
-export { default as ResourcePropDescription } from './resources/props/description.mdx';
-export { default as ResourcePropValue } from './resources/props/value.mdx';
-export { default as ResourcePropValues } from './resources/props/values.mdx';
-export { default as ResourcePropMerge } from './resources/props/merge.mdx';
-export { default as Version } from './version.mdx';
-
-
+export { default as Name } from "./name.mdx";
+export { default as Description } from "./description.mdx";
+export { default as Providers } from "./providers.mdx";
+export { default as Globals } from "./globals.mdx";
+export { default as GlobalName } from "./globals/name.mdx";
+export { default as GlobalDescription } from "./globals/description.mdx";
+export { default as GlobalValue } from "./globals/value.mdx";
+export { default as Resources } from "./resources.mdx";
+export { default as ResourceName } from "./resources/name.mdx";
+export { default as ResourceType } from "./resources/type.mdx";
+export { default as ResourceFile } from "./resources/file.mdx";
+export { default as ResourceDescription } from "./resources/description.mdx";
+export { default as ResourceExports } from "./resources/exports.mdx";
+export { default as ResourceProps } from "./resources/props.mdx";
+export { default as ResourceProtected } from "./resources/protected.mdx";
+export { default as ResourceAuth } from "./resources/auth.mdx";
+export { default as ResourceIf } from "./resources/if.mdx";
+export { default as ResourcePropName } from "./resources/props/name.mdx";
+export { default as ResourcePropDescription } from "./resources/props/description.mdx";
+export { default as ResourcePropValue } from "./resources/props/value.mdx";
+export { default as ResourcePropValues } from "./resources/props/values.mdx";
+export { default as ResourcePropMerge } from "./resources/props/merge.mdx";
+export { default as Version } from "./version.mdx";

website/docs/manifest_fields/resources.mdx

@@ -12,6 +12,7 @@ import LeftAlignedTable from '@site/src/components/LeftAlignedTable';
     { name: 'resource.exports', anchor: 'resourceexports' },
     { name: 'resource.protected', anchor: 'resourceprotected' },
     { name: 'resource.description', anchor: 'resourcedescription' },
+    { name: 'resource.if', anchor: 'resourceif' },
   ]} 
 />
 
@@ -52,4 +53,4 @@ A file with the name of the resource with an `.iql` extension is expected to exi
 
 </File>
 
-:::
+:::

website/docs/manifest_fields/resources/if.mdx

@@ -0,0 +1,47 @@
+import File from '@site/src/components/File';
+import LeftAlignedTable from '@site/src/components/LeftAlignedTable';
+
+<LeftAlignedTable type="string" required={false} />
+
+A conditional expression that determines whether a resource should be tested, provisioned, or deprovisioned.
+You can use Python expressions to conditionally determine if a resource should be processed.
+
+<File name='stackql_manifest.yml'>
+
+```yaml {3}
+resources:
+- name: get_transfer_kms_key_id
+  if: "environment == 'production'"
+...
+```
+
+</File>
+
+:::info
+
+- Conditions are evaluated as Python expressions.
+- You can reference literals (string, boolean, integer, etc.) or runtime template variables.
+- If the condition evaluates to `True`, the resource is processed; if `False`, it is skipped.
+- Template variables can be referenced using Jinja2 template syntax (`{{ variable }}`).
+
+:::
+
+## Examples
+
+Conditionally process a resource based on environment:
+
+```yaml
+resources:
+  - name: get_transfer_kms_key_id
+    if: "environment == 'production'"
+    ...
+```
+
+Conditionally process based on other variable values:
+
+```yaml
+resources:
+  - name: get_transfer_kms_key_id
+    if: "some_var == '{{ some_other_var_value }}'"
+    ...
+```