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(documentation): Update language in documentation #99

Merged
merged 23 commits into from
Nov 16, 2023

Conversation

justintlewis
Copy link
Contributor

Minor langauge tweaks to the readme before public release.


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

Signed-off-by: justintlewis <jtlew@amazon.com>
Correct grammatical error in operational metrics notice.

Signed-off-by: justintlewis <jtlew@amazon.com>
Copy link

codecov bot commented Nov 15, 2023

Codecov Report

All modified and coverable lines are covered by tests ✅

❗ No coverage uploaded for pull request base (main@af41792). Click here to learn what that means.

❗ Current head 4aea08d differs from pull request most recent head bc300e7. Consider uploading reports for the commit bc300e7 to get more accurate results

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #99   +/-   ##
=======================================
  Coverage        ?   93.54%           
=======================================
  Files           ?       16           
  Lines           ?     4599           
  Branches        ?      108           
=======================================
  Hits            ?     4302           
  Misses          ?      297           
  Partials        ?        0           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

Signed-off-by: justintlewis <jtlew@amazon.com>
Signed-off-by: justintlewis <jtlew@amazon.com>
Signed-off-by: justintlewis <jtlew@amazon.com>
Signed-off-by: justintlewis <jtlew@amazon.com>
Signed-off-by: justintlewis <jtlew@amazon.com>
Signed-off-by: justintlewis <jtlew@amazon.com>
Signed-off-by: justintlewis <jtlew@amazon.com>
Signed-off-by: justintlewis <jtlew@amazon.com>
@scottschreckengaust scottschreckengaust changed the title Update README.md chore: Update README.md Nov 16, 2023
@justintlewis justintlewis changed the title chore: Update README.md Update readmes Nov 16, 2023
@justintlewis justintlewis changed the title Update readmes Update language in documentation Nov 16, 2023
@krokoko krokoko changed the title Update language in documentation feat(documentation): Update language in documentation Nov 16, 2023
@justintlewis justintlewis marked this pull request as ready for review November 16, 2023 00:18
@justintlewis justintlewis requested a review from a team as a code owner November 16, 2023 00:18
Co-authored-by: Scott Schreckengaust <scottschreckengaust@users.noreply.github.com>
Signed-off-by: justintlewis <justin@justintlewis.com>
Copy link
Collaborator

@scottschreckengaust scottschreckengaust left a comment

Choose a reason for hiding this comment

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

There are a few instances where AWS is in front of the "Generative AI CDK" and some without.

Co-authored-by: Scott Schreckengaust <scottschreckengaust@users.noreply.github.com>
Signed-off-by: justintlewis <justin@justintlewis.com>
@@ -1,10 +1,10 @@
# Developer Guide

Generative AI Constructs are built in typescript using Projen (http://projen.io/). This is to support all the associated testing, code checking and compilation for Typescript and Python client. At the moment, there is no dedicated development container, thus you need to configure your local development environment following the steps described below.
Generative AI CDK Constructs are built in TypeScript using Projen (http://projen.io/). This is to support all the associated testing, code checking, and compilation for TypeScript and Python client. At the moment, there is no dedicated development container, thus you need to configure your local development environment following the steps described below.

This comment was marked as resolved.


## Testing

Generative AI Constructs use 2 flavors of testing, unit testing and integration testing. Unit testing targets specific aspects of a construct or one of the functions in the core library. It examines the results and confirms the correct resources are there. For instance, it may call the deployLambdaFunction() in the core library and then confirm that AWS_NODEJS_CONNECTION_REUSE_ENABLED environment variable was set correctly. The unit tests check that certain aspects of the results are correct. You can learn more about unit testing CDK constructs [here](https://docs.aws.amazon.com/cdk/latest/guide/testing.html) and [here](https://aws.amazon.com/blogs/developer/testing-infrastructure-with-the-aws-cloud-development-kit-cdk/).
Generative AI CDK Constructs use two types of testing: unit testing and integration testing. Unit testing targets specific aspects of a construct or one of the functions in the core library. It examines the results and confirms the correct resources are there. For instance, it may call the deployLambdaFunction() in the core library and then confirm that AWS_NODEJS_CONNECTION_REUSE_ENABLED environment variable was set correctly. The unit tests check that certain aspects of the results are correct. You can learn more about unit testing CDK constructs [here](https://docs.aws.amazon.com/cdk/latest/guide/testing.html) and [here](https://aws.amazon.com/blogs/developer/testing-infrastructure-with-the-aws-cloud-development-kit-cdk/).

This comment was marked as resolved.

justintlewis and others added 5 commits November 15, 2023 16:27
Signed-off-by: justintlewis <jtlew@amazon.com>
Co-authored-by: Scott Schreckengaust <scottschreckengaust@users.noreply.github.com>
Signed-off-by: justintlewis <justin@justintlewis.com>
Signed-off-by: justintlewis <jtlew@amazon.com>
Signed-off-by: justintlewis <jtlew@amazon.com>
Signed-off-by: justintlewis <jtlew@amazon.com>
Co-authored-by: Scott Schreckengaust <scottschreckengaust@users.noreply.github.com>
Signed-off-by: justintlewis <justin@justintlewis.com>
DESIGN_GUIDELINES.md Outdated Show resolved Hide resolved
@justintlewis justintlewis merged commit 144f59a into main Nov 16, 2023
5 checks passed
@justintlewis justintlewis deleted the feature/readme-cleanup branch November 16, 2023 01:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants