Skip to content

fix(python): parameter names in docstrings should be snake_case, not camelCase#539

Merged
eladb merged 2 commits intoaws:masterfrom
garnaat:fix-538
Jun 24, 2019
Merged

fix(python): parameter names in docstrings should be snake_case, not camelCase#539
eladb merged 2 commits intoaws:masterfrom
garnaat:fix-538

Conversation

@garnaat
Copy link
Copy Markdown
Contributor

@garnaat garnaat commented Jun 17, 2019

Fixes #538.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

@garnaat garnaat added the language/python Related to Python bindings label Jun 17, 2019
@garnaat garnaat requested a review from a team as a code owner June 17, 2019 13:46
@garnaat garnaat self-assigned this Jun 17, 2019
Copy link
Copy Markdown
Contributor

@eladb eladb left a comment

Choose a reason for hiding this comment

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

I would expect pacmak test expectations to be updated.

optionalArray:
non_primitive: An example of a non primitive property.
another_optional: This is optional.
optional_any:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

What do we think about the params without text? how does this render? Should we add some placeholder text?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Well, the current code returns a - character if there are not docs for the argument but that causes things to render funny, as in https://docs.aws.amazon.com/cdk/api/latest/python/aws_cdk.aws_ecs/Ec2Service.html#aws_cdk.aws_ecs.Ec2Service.add_placement_constraints. I think that should be changed, either to a blank character, empty string, or some other default string.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Not sure I follow... So this is okay?

@eladb eladb merged commit a91a315 into aws:master Jun 24, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

language/python Related to Python bindings

Projects

None yet

Development

Successfully merging this pull request may close these issues.

python: parameter names in docstrings are camelCase not snake_case

2 participants