Skip to content
This repository was archived by the owner on Jul 16, 2024. It is now read-only.

Commit 837852b

Browse files
lmouhibAutomation
andauthored
fix: exclude example.ts from documentation (#303)
* docs: added the ignore tag for TypeDoc to not include example.ts in API.md and not have it in construct hub Co-authored-by: Lotfi Mouhib <mouhib@amazon.com> Co-authored-by: Automation <github-actions@github.com>
1 parent 300e2ab commit 837852b

File tree

2 files changed

+7
-8
lines changed

2 files changed

+7
-8
lines changed

core/API.md

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1664,11 +1664,6 @@ public readonly sharedDefaultConfig: string;
16641664

16651665
### Example <a name="Example" id="aws-analytics-reference-architecture.Example"></a>
16661666

1667-
Example Construct to help onboarding contributors.
1668-
1669-
This example includes best practices for code comment/documentation generation,
1670-
and for default parameters pattern in CDK using Props with Optional properties
1671-
16721667
#### Initializers <a name="Initializers" id="aws-analytics-reference-architecture.Example.Initializer"></a>
16731668

16741669
```typescript
@@ -5335,8 +5330,6 @@ name of the Amazon EKS namespace to be linked to the Amazon EMR virtual cluster.
53355330

53365331
### ExampleProps <a name="ExampleProps" id="aws-analytics-reference-architecture.ExampleProps"></a>
53375332

5338-
The properties for the Example Construct class.
5339-
53405333
#### Initializer <a name="Initializer" id="aws-analytics-reference-architecture.ExampleProps.Initializer"></a>
53415334

53425335
```typescript

core/src/example.ts

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44
import { Construct, CfnOutput } from '@aws-cdk/core';
55

66
/**
7+
* @ignore
8+
* // DO NOT include ignore tag, if you do TypeDoc will not include documentation of your construct
79
* The properties for the Example Construct class.
810
*/
911

@@ -21,6 +23,8 @@ export interface ExampleProps {
2123
}
2224

2325
/**
26+
* @ignore
27+
* // DO NOT include ignore tag, if you do TypeDoc will not include documentation of your construct
2428
* Example Construct to help onboarding contributors.
2529
* This example includes best practices for code comment/documentation generation,
2630
* and for default parameters pattern in CDK using Props with Optional properties
@@ -29,6 +33,8 @@ export interface ExampleProps {
2933
export class Example extends Construct {
3034

3135
/**
36+
* @ignore
37+
* // DO NOT include ignore tag, if you do TypeDoc will not include documentation of your construct
3238
* Constructs a new instance of the Example class with CfnOutput.
3339
* CfnOutput can be customized.
3440
* @param {Construct} scope the Scope of the CDK Construct
@@ -47,4 +53,4 @@ export class Example extends Construct {
4753
value: props.value ? props.value: 'defaultValue!',
4854
});
4955
}
50-
}
56+
}

0 commit comments

Comments
 (0)