Skip to content

Commit c5bc7d6

Browse files
authored
chore(rosetta): final documentation compilation automation update (#1173)
1 parent 6da874d commit c5bc7d6

File tree

50 files changed

+836
-886
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

50 files changed

+836
-886
lines changed

DEVELOPER_GUIDE.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,10 @@ Default region name [None]: us-east-1
1515
Default output format [None]: json
1616
```
1717

18-
- [Node](https://nodejs.org/en) >= v20.9.0
18+
- [Node](https://nodejs.org/en) >= v22.0.0
1919
- [AWS CDK](https://github.com/aws/aws-cdk/releases/tag/v2.219.0) >= 2.219.0
2020
- [Python](https://www.python.org/downloads/) >=3.9
21-
- [Projen](https://github.com/projen/projen) >= 0.91.5
21+
- [Projen](https://github.com/projen/projen/releases/tag/v0.98.0) >= 0.98.0
2222
- [Yarn](https://classic.yarnpkg.com/lang/en/docs/cli/install/) >= 1.22.19
2323

2424
You can use the command below to install the dependencies listed above
@@ -128,6 +128,10 @@ Navigate to the [Generative AI CDK Construct Repository] (https://github.com/aws
128128
129129
## Project structure
130130
131+
For each new pattern, ensure:
132+
- that you export it from the main [index.ts](./src/index.ts) file as a named export to avoid name collisions and ensure that the underlying tools can process correctly the documentation
133+
- have a single main README.md
134+
131135
```
132136
.
133137
|--docs/ (draw.io project containing architecture diagrams for all constructs)

DOCUMENTATION_TESTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ typescript fixture=default
5656
Run the documentation verification:
5757

5858
```bash
59-
yarn docs:compile
59+
projen docs:compile
6060
```
6161

6262
This will:

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -135,9 +135,9 @@ The following constructs are available in the library:
135135

136136
| **Construct** |Description| AWS Services used |
137137
|:-------------|:-------------|:-------------|
138-
| [SageMaker model deployment (JumpStart)](./src/patterns/gen-ai/aws-model-deployment-sagemaker/README_jumpstart.md) | Deploy a foundation model from Amazon SageMaker JumpStart to an Amazon SageMaker endpoint. | Amazon SageMaker |
139-
| [SageMaker model deployment (Hugging Face)](./src/patterns/gen-ai/aws-model-deployment-sagemaker/README_hugging_face.md) | Deploy a foundation model from Hugging Face to an Amazon SageMaker endpoint. | Amazon SageMaker |
140-
| [SageMaker model deployment (Custom)](./src/patterns/gen-ai/aws-model-deployment-sagemaker/README_custom_sagemaker_endpoint.md) | Deploy a foundation model from an S3 location to an Amazon SageMaker endpoint. | Amazon SageMaker |
138+
| [SageMaker model deployment (JumpStart)](./src/patterns/gen-ai/aws-model-deployment-sagemaker/README.md) | Deploy a foundation model from Amazon SageMaker JumpStart to an Amazon SageMaker endpoint. | Amazon SageMaker |
139+
| [SageMaker model deployment (Hugging Face)](./src/patterns/gen-ai/aws-model-deployment-sagemaker/README.md) | Deploy a foundation model from Hugging Face to an Amazon SageMaker endpoint. | Amazon SageMaker |
140+
| [SageMaker model deployment (Custom)](./src/patterns/gen-ai/aws-model-deployment-sagemaker/README.md) | Deploy a foundation model from an S3 location to an Amazon SageMaker endpoint. | Amazon SageMaker |
141141
| [Amazon Bedrock Monitoring (Amazon CloudWatch Dashboard)](./src/patterns/gen-ai/aws-bedrock-cw-dashboard/README.md) | Amazon CloudWatch dashboard to monitor model usage from Amazon Bedrock. | Amazon CloudWatch |
142142
| [Bedrock Data Automation](./src/patterns/gen-ai/aws-bedrock-data-automation/README.md) | Use Amazon bedrock data automation client to to build and manage intelligent document processing, media analysis, and other multimodal data-centric automation solutions | AWS Lambda, Amazon S3 bucket |
143143
| [Bedrock Batch Step Functions](./src/patterns/gen-ai/aws-bedrock-batch-stepfn/README.md) | Manage Bedrock model invocation jobs(batch inference) in AWS Step Functions state machines | AWS Step Functions, AWS Lambda, AWS EventBridge, Amazon Bedrock, AWS IAM |
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
[**@cdklabs/generative-ai-cdk-constructs**](../../../README.md)
2+
3+
***
4+
5+
[@cdklabs/generative-ai-cdk-constructs](../../../README.md) / aosscwdashboard
6+
7+
# aosscwdashboard
8+
9+
## Classes
10+
11+
- [AossCwDashboard](classes/AossCwDashboard.md)
12+
13+
## Interfaces
14+
15+
- [AossCwDashboardProps](interfaces/AossCwDashboardProps.md)
16+
- [CollectionMonitoringProps](interfaces/CollectionMonitoringProps.md)
17+
- [IndexMonitoringProps](interfaces/IndexMonitoringProps.md)

apidocs/classes/AossCwDashboard.md renamed to apidocs/@cdklabs/namespaces/aosscwdashboard/classes/AossCwDashboard.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
[**@cdklabs/generative-ai-cdk-constructs**](../README.md)
1+
[**@cdklabs/generative-ai-cdk-constructs**](../../../../README.md)
22

33
***
44

5-
[@cdklabs/generative-ai-cdk-constructs](../README.md) / AossCwDashboard
5+
[@cdklabs/generative-ai-cdk-constructs](../../../../README.md) / [aosscwdashboard](../README.md) / AossCwDashboard
66

77
# Class: AossCwDashboard
88

apidocs/interfaces/AossCwDashboardProps.md renamed to apidocs/@cdklabs/namespaces/aosscwdashboard/interfaces/AossCwDashboardProps.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
[**@cdklabs/generative-ai-cdk-constructs**](../README.md)
1+
[**@cdklabs/generative-ai-cdk-constructs**](../../../../README.md)
22

33
***
44

5-
[@cdklabs/generative-ai-cdk-constructs](../README.md) / AossCwDashboardProps
5+
[@cdklabs/generative-ai-cdk-constructs](../../../../README.md) / [aosscwdashboard](../README.md) / AossCwDashboardProps
66

77
# Interface: AossCwDashboardProps
88

apidocs/interfaces/CollectionMonitoringProps.md renamed to apidocs/@cdklabs/namespaces/aosscwdashboard/interfaces/CollectionMonitoringProps.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
[**@cdklabs/generative-ai-cdk-constructs**](../README.md)
1+
[**@cdklabs/generative-ai-cdk-constructs**](../../../../README.md)
22

33
***
44

5-
[@cdklabs/generative-ai-cdk-constructs](../README.md) / CollectionMonitoringProps
5+
[@cdklabs/generative-ai-cdk-constructs](../../../../README.md) / [aosscwdashboard](../README.md) / CollectionMonitoringProps
66

77
# Interface: CollectionMonitoringProps
88

apidocs/interfaces/IndexMonitoringProps.md renamed to apidocs/@cdklabs/namespaces/aosscwdashboard/interfaces/IndexMonitoringProps.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
[**@cdklabs/generative-ai-cdk-constructs**](../README.md)
1+
[**@cdklabs/generative-ai-cdk-constructs**](../../../../README.md)
22

33
***
44

5-
[@cdklabs/generative-ai-cdk-constructs](../README.md) / IndexMonitoringProps
5+
[@cdklabs/generative-ai-cdk-constructs](../../../../README.md) / [aosscwdashboard](../README.md) / IndexMonitoringProps
66

77
# Interface: IndexMonitoringProps
88

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
[**@cdklabs/generative-ai-cdk-constructs**](../../../README.md)
2+
3+
***
4+
5+
[@cdklabs/generative-ai-cdk-constructs](../../../README.md) / bda
6+
7+
# bda
8+
9+
## Classes
10+
11+
- [BedrockDataAutomation](classes/BedrockDataAutomation.md)
12+
13+
## Interfaces
14+
15+
- [BedrockDataAutomationProps](interfaces/BedrockDataAutomationProps.md)

apidocs/classes/BedrockDataAutomation.md renamed to apidocs/@cdklabs/namespaces/bda/classes/BedrockDataAutomation.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
1-
[**@cdklabs/generative-ai-cdk-constructs**](../README.md)
1+
[**@cdklabs/generative-ai-cdk-constructs**](../../../../README.md)
22

33
***
44

5-
[@cdklabs/generative-ai-cdk-constructs](../README.md) / BedrockDataAutomation
5+
[@cdklabs/generative-ai-cdk-constructs](../../../../README.md) / [bda](../README.md) / BedrockDataAutomation
66

77
# Class: BedrockDataAutomation
88

99
Class to create a BDA pattern with CDK.
1010

1111
## Extends
1212

13-
- [`BaseClass`](BaseClass.md)
13+
- [`BaseClass`](../../../../classes/BaseClass.md)
1414

1515
## Constructors
1616

@@ -38,7 +38,7 @@ Class to create a BDA pattern with CDK.
3838

3939
#### Overrides
4040

41-
[`BaseClass`](BaseClass.md).[`constructor`](BaseClass.md#constructor)
41+
[`BaseClass`](../../../../classes/BaseClass.md).[`constructor`](../../../../classes/BaseClass.md#constructor)
4242

4343
## Properties
4444

@@ -118,7 +118,7 @@ construct usage metric , added in template description
118118

119119
#### Inherited from
120120

121-
[`BaseClass`](BaseClass.md).[`constructUsageMetric`](BaseClass.md#constructusagemetric)
121+
[`BaseClass`](../../../../classes/BaseClass.md).[`constructUsageMetric`](../../../../classes/BaseClass.md#constructusagemetric)
122122

123123
***
124124

@@ -136,7 +136,7 @@ enable disable xray tracing
136136

137137
#### Inherited from
138138

139-
[`BaseClass`](BaseClass.md).[`enablexray`](BaseClass.md#enablexray)
139+
[`BaseClass`](../../../../classes/BaseClass.md).[`enablexray`](../../../../classes/BaseClass.md#enablexray)
140140

141141
***
142142

@@ -148,7 +148,7 @@ Default log config for all constructs
148148

149149
#### Inherited from
150150

151-
[`BaseClass`](BaseClass.md).[`fieldLogLevel`](BaseClass.md#fieldloglevel)
151+
[`BaseClass`](../../../../classes/BaseClass.md).[`fieldLogLevel`](../../../../classes/BaseClass.md#fieldloglevel)
152152

153153
***
154154

@@ -166,7 +166,7 @@ enable disable lambda tracing
166166

167167
#### Inherited from
168168

169-
[`BaseClass`](BaseClass.md).[`lambdaTracing`](BaseClass.md#lambdatracing)
169+
[`BaseClass`](../../../../classes/BaseClass.md).[`lambdaTracing`](../../../../classes/BaseClass.md#lambdatracing)
170170

171171
***
172172

@@ -178,7 +178,7 @@ The tree node.
178178

179179
#### Inherited from
180180

181-
[`BaseClass`](BaseClass.md).[`node`](BaseClass.md#node)
181+
[`BaseClass`](../../../../classes/BaseClass.md).[`node`](../../../../classes/BaseClass.md#node)
182182

183183
***
184184

@@ -198,7 +198,7 @@ Default log retention config for all constructs
198198

199199
#### Inherited from
200200

201-
[`BaseClass`](BaseClass.md).[`retention`](BaseClass.md#retention)
201+
[`BaseClass`](../../../../classes/BaseClass.md).[`retention`](../../../../classes/BaseClass.md#retention)
202202

203203
***
204204

@@ -216,7 +216,7 @@ Value will be appended to resources name.
216216

217217
#### Inherited from
218218

219-
[`BaseClass`](BaseClass.md).[`stage`](BaseClass.md#stage)
219+
[`BaseClass`](../../../../classes/BaseClass.md).[`stage`](../../../../classes/BaseClass.md#stage)
220220

221221
***
222222

@@ -228,7 +228,7 @@ Record<string, number> , maps construct name with number of deployments
228228

229229
#### Inherited from
230230

231-
[`BaseClass`](BaseClass.md).[`usageMetricMap`](BaseClass.md#usagemetricmap)
231+
[`BaseClass`](../../../../classes/BaseClass.md).[`usageMetricMap`](../../../../classes/BaseClass.md#usagemetricmap)
232232

233233
## Methods
234234

@@ -240,15 +240,15 @@ Record<string, number> , maps construct name with number of deployments
240240

241241
##### props
242242

243-
[`BaseClassProps`](../interfaces/BaseClassProps.md)
243+
[`BaseClassProps`](../../../../interfaces/BaseClassProps.md)
244244

245245
#### Returns
246246

247247
`void`
248248

249249
#### Inherited from
250250

251-
[`BaseClass`](BaseClass.md).[`addObservabilityToConstruct`](BaseClass.md#addobservabilitytoconstruct)
251+
[`BaseClass`](../../../../classes/BaseClass.md).[`addObservabilityToConstruct`](../../../../classes/BaseClass.md#addobservabilitytoconstruct)
252252

253253
***
254254

@@ -264,7 +264,7 @@ Returns a string representation of this construct.
264264

265265
#### Inherited from
266266

267-
[`BaseClass`](BaseClass.md).[`toString`](BaseClass.md#tostring)
267+
[`BaseClass`](../../../../classes/BaseClass.md).[`toString`](../../../../classes/BaseClass.md#tostring)
268268

269269
***
270270

@@ -276,7 +276,7 @@ Returns a string representation of this construct.
276276

277277
##### props
278278

279-
[`BaseClassProps`](../interfaces/BaseClassProps.md)
279+
[`BaseClassProps`](../../../../interfaces/BaseClassProps.md)
280280

281281
##### scope
282282

@@ -292,7 +292,7 @@ Returns a string representation of this construct.
292292

293293
#### Inherited from
294294

295-
[`BaseClass`](BaseClass.md).[`updateConstructUsageMetricCode`](BaseClass.md#updateconstructusagemetriccode)
295+
[`BaseClass`](../../../../classes/BaseClass.md).[`updateConstructUsageMetricCode`](../../../../classes/BaseClass.md#updateconstructusagemetriccode)
296296

297297
***
298298

@@ -304,15 +304,15 @@ Returns a string representation of this construct.
304304

305305
##### props
306306

307-
[`BaseClassProps`](../interfaces/BaseClassProps.md)
307+
[`BaseClassProps`](../../../../interfaces/BaseClassProps.md)
308308

309309
#### Returns
310310

311311
`void`
312312

313313
#### Inherited from
314314

315-
[`BaseClass`](BaseClass.md).[`updateEnvSuffix`](BaseClass.md#updateenvsuffix)
315+
[`BaseClass`](../../../../classes/BaseClass.md).[`updateEnvSuffix`](../../../../classes/BaseClass.md#updateenvsuffix)
316316

317317
***
318318

@@ -352,4 +352,4 @@ true if `x` is an object created from a class which extends `Construct`.
352352

353353
#### Inherited from
354354

355-
[`BaseClass`](BaseClass.md).[`isConstruct`](BaseClass.md#isconstruct)
355+
[`BaseClass`](../../../../classes/BaseClass.md).[`isConstruct`](../../../../classes/BaseClass.md#isconstruct)

0 commit comments

Comments
 (0)