Skip to content
New issue

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

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

Already on GitHub? # 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.

@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.

@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
@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*
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants