Skip to content

docs(parameters): main docs for the utility #1215

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

Merged
merged 8 commits into from
Jan 10, 2023

Conversation

dreamorosi
Copy link
Contributor

@dreamorosi dreamorosi commented Jan 6, 2023

Description of your changes

How to verify this change

Related issues, RFCs

Issue number: #1034

PR status

Is this ready for review?: NO
Is it a breaking change?: NO

Checklist

  • My changes meet the tenets criteria
  • I have performed a self-review of my own code
  • I have commented my code where necessary, particularly in areas that should be flagged with a TODO, or hard-to-understand areas
  • I have made corresponding changes to the documentation
  • I have made corresponding changes to the examples
  • My changes generate no new warnings
  • The code coverage hasn't decreased
  • I have added tests that prove my change is effective and works
  • New and existing unit tests pass locally and in Github Actions
  • Any dependent changes have been merged and published
  • The PR title follows the conventional commit semantics

Breaking change checklist

  • I have documented the migration process
  • I have added, implemented necessary warnings (if it can live side by side)

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

@dreamorosi dreamorosi self-assigned this Jan 6, 2023
@dreamorosi dreamorosi linked an issue Jan 6, 2023 that may be closed by this pull request
@pull-request-size pull-request-size bot added the size/XL PRs between 500-999 LOC, often PRs that grown with feedback label Jan 6, 2023
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Jan 6, 2023
@dreamorosi dreamorosi marked this pull request as ready for review January 7, 2023 16:41
shdq
shdq previously approved these changes Jan 10, 2023
Copy link
Contributor

@shdq shdq left a comment

Choose a reason for hiding this comment

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

Looks great!

I only find the section about the transformation a bit confusing, despite I worked with it and know how it works inside. We can improve it by explicitly writing that the result of the transformation is string. And another suggestion is to change the name of the argument to transformFrom: 'binary' in parameters before we released it.


| Parameter | Default | Description |
| ------------- | ------- | --------------------------------------------------------------------------------------------- |
| **decrypt** | `false` | Will automatically decrypt the parameter. |
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe it is worth adding a reminder about IAM Permissions for decrypt. Like "required kms:Decrypt IAM permission"

Comment on lines +6 to +9
/**
* Retrieve multiple values by performing a Query on the DynamoDB table.
* This returns a dict with the sort key attribute as dict key.
*/
Copy link
Contributor

Choose a reason for hiding this comment

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

Fix comment indentation

@dreamorosi dreamorosi merged commit 0d68f59 into main Jan 10, 2023
@dreamorosi dreamorosi deleted the 1034-docs-write-main-docs-for-the-utility branch January 10, 2023 15:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation size/XL PRs between 500-999 LOC, often PRs that grown with feedback
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Docs: write main docs for the utility
2 participants