Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(typewriter): Add docTags map to DocsSpec interface. #538

Merged
merged 6 commits into from
Sep 20, 2023

Conversation

mikewrighton
Copy link
Contributor

@mikewrighton mikewrighton commented Sep 15, 2023

Add docTags field to the DocSpec interface.

This is a dependency of aws/aws-cdk#26839.

packages/@cdklabs/typewriter/src/documented.ts Outdated Show resolved Hide resolved
@mrgrain
Copy link
Contributor

mrgrain commented Sep 18, 2023

The PR title also needs some tweaking. Different scope and in the context of this repo, I'd say this will be a feature.

@mikewrighton mikewrighton changed the title fix(awslint): Add cloudformationResource field to DocSpec interface. feat(typewriter): Add docTags map to DocSpec interface. Sep 18, 2023
@mikewrighton mikewrighton changed the title feat(typewriter): Add docTags map to DocSpec interface. feat(typewriter): Add docTags map to DocsSpec interface. Sep 18, 2023
@rix0rrr rix0rrr marked this pull request as draft September 20, 2023 07:33
auto-merge was automatically disabled September 20, 2023 07:33

Pull request was converted to draft

Copy link
Contributor

@rix0rrr rix0rrr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Conditional approval (I made it a Draft). Address my comment or not (your choice), and then make it a proper PR again to merge at your leisure.

packages/@cdklabs/typewriter/src/documented.ts Outdated Show resolved Hide resolved
@mikewrighton mikewrighton marked this pull request as ready for review September 20, 2023 17:38
@mikewrighton mikewrighton dismissed mrgrain’s stale review September 20, 2023 18:07

Addressed comment in latest commit

@aws-cdk-automation aws-cdk-automation added this pull request to the merge queue Sep 20, 2023
Merged via the queue into main with commit 54cd5c3 Sep 20, 2023
9 checks passed
@aws-cdk-automation aws-cdk-automation deleted the mikewrighton-26839 branch September 20, 2023 18:16
mergify bot pushed a commit to aws/aws-cdk that referenced this pull request Sep 22, 2023
Various fixes to awslint. Also adds new exclusions to prevent existing lint errors from failing the build - will address these errors in a follow-up. Linter config, including exclusions, has been moved into a new file `awslint.json`. If this file does not exist, the linter will continue reading and updating the config in `package.json`. Fixes #26839.

Linter changes:
- Include symbols from submodules by using e.g. `assembly.allClasses` instead of `assembly.classes`
- Fix FQNs in the construct linter by including the submodule name
- Use `cloudformationResource` tag (added in cdklabs/awscdk-service-spec#538) to store CFN resource ID when generating L1 constructs. This is used in the CFN resource linter.
- Fix `core-types.ts` to use new package names
- Ignore version suffixes when guessing resource names in `packages/awslint/lib/rules/resource.ts`

The change in `aws-apigateway/lib/resource.ts` is an example of a `props-physical-name` fix.

Breakdown of new linter errors:
```
docs-public-apis: 2308
props-default-doc: 214
props-physical-name: 106
attribute-tag: 13
construct-interface-extends-iconstruct: 8
resource-interface-extends-resource: 8
from-method: 8
props-no-cfn-types: 7
ref-via-interface: 5
from-signature: 4
construct-ctor-props-optional: 3
props-no-arn-refs: 3
props-no-any: 2
integ-return-type: 2
module-name: 1
construct-ctor: 1
props-struct-name: 1
construct-ctor-props-type: 1
no-static-import: 1
public-static-props-all-caps: 1
Total: 2697
```

### Tasks
- [x] Push cdklabs/awscdk-service-spec#538 before merging

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants