Fix:Language Parity Stance and Links (#932)

Co-authored-by: Michael Kaiser <[email protected]>
Co-authored-by: Eric Z. Beard <[email protected]>

Author: 3 people

CONTRIBUTING.md

@@ -9,21 +9,19 @@ information to effectively respond to your bug report or contribution.
 ## Table of Contents
 1. [Reporting Bugs/Feature Requests](#Reporting)
 2. [Contributing via Pull Requests](#Pulls)
-3. [Adding an Example](#New)
 4. [Linking External Example](#Extern)
 5. [Style and Formatting](#Style)
 6. [Finding Contributions to Work On](#Finding)
 7. [Adding Learning Resources](#Resources)
-8. [Code of Conduct](CoC)
+8. [Code of Conduct](#CoC)
 9. [Security Issue Notifications](#Security)
 10. [Licensing](#License)
 
 ## Reporting Bugs/Feature Requests <a name="Reporting"></a>
 
 We welcome you to use the GitHub issue tracker to report bugs or suggest features.
 
-When filing an issue, please check [existing open](https://github.com/aws-samples/aws-cdk-examples/issues), or [recently closed](https://github.com/aws-samples/aws-cdk-examples/issues?utf8=%E2%9C%93&q=is%3Aissue%20is%3Aclosed%20), issues to make sure somebody else hasn't already
-reported the issue. Please try to include as much information as you can. Details like these are incredibly useful:
+When filing an issue, please check [existing open](https://github.com/aws-samples/aws-cdk-examples/issues), or [recently closed](https://github.com/aws-samples/aws-cdk-examples/issues?utf8=%E2%9C%93&q=is%3Aissue%20is%3Aclosed%20), issues to make sure somebody else hasn't already reported the issue. Please try to include as much information as you can. Details like these are incredibly useful:
 
 * A reproducible test case or series of steps
 * The version of our code being used
@@ -35,12 +33,12 @@ Contributions via pull requests are much appreciated. Before sending us a pull r
 
 1. You are working against the latest source on the *master* branch.
 2. You check existing open, and recently merged, pull requests to make sure someone else hasn't addressed the problem already.
-3. You open an issue to discuss any significant work - we would hate for your time to be wasted.
 
 To send us a pull request, please:
 
 1. Fork the repository.
 2. Modify the source; please focus on the specific change you are contributing. If you also reformat all the code, it will be hard for us to focus on your change.
+4. Ensure your example passes `cdk synth` or indicate in the PR why it does not. 
 3. Ensure local tests pass automated tests (check the [scripts](https://github.com/aws-samples/aws-cdk-examples/tree/master/scripts) directory)
 4. Commit to your fork using clear commit messages.
 5. Send us a pull request, answering any default questions in the pull request interface.
@@ -49,10 +47,6 @@ To send us a pull request, please:
 GitHub provides additional document on [forking a repository](https://help.github.com/articles/fork-a-repo/) and
 [creating a pull request](https://help.github.com/articles/creating-a-pull-request/).
 
-## Adding an Example <a name="New"></a>
-
-When adding a new example, there are several things important to consider as you implement (please create a [`feature-request` issue](https://github.com/aws-samples/aws-cdk-examples/issues/new?labels=feature-request%2C+needs-triage&template=feature-request.md) to discuss these before writing your contribution):
-
 ### Added Value
 As an official learning resource, it is important that any new examples add value to our learning resources. This means that it should not duplicate an existing example, and cover one of the following topics:
 
@@ -62,11 +56,6 @@ As an official learning resource, it is important that any new examples add valu
 
 When we are considering merging a new contribution we will review the above criteria as well as evaluating quality based on the criteria in the following sections.
 
-### Language Parity
-While we have historically allowed adding examples in just one of our supported languages, moving forward we would like to maintain language parity. This does not necessarily mean that you must write the example in each language yourself, but a PR will not be merged until the example has been added for each language.
-
-If you are looking for help to achieve language parity, you can request help in either the issue related to the new example, or directly through the PR.
-
 ### Components
 
 When adding a new example, there are several required components. The majority of these will be added when running `cdk init`.
@@ -143,7 +132,7 @@ Looking at the existing issues is a great way to find something to contribute on
 ## Adding Learning Resources <a name="Resources"></a>
 On the main README of this repo, we maintain a shortlist of additional learning resources related to the CDK. The "Officially Supported" section will be maintained by CDK project maintainers, however if you have a resource (workshop, example-set, etc.) you think should be added to the list, create a PR with your reasoning for adding in the description and a CDK maintainer will discuss with you in PR reviews.
 
-When adding a resource (or external example), please make the same considerations you would for [adding a new example](#New).
+When adding a resource (or external example), please make the same considerations you would for [adding a new example](#Pulls).
 
 ## Code of Conduct <a name="CoC"></a>
 This project has adopted the [Amazon Open Source Code of Conduct](https://aws.github.io/code-of-conduct).

README.md

@@ -1,7 +1,7 @@
 # AWS CDK Examples
 
 This repository contains a set of example projects for the [AWS Cloud Development
-Kit](https://github.com/awslabs/aws-cdk).
+Kit](https://github.com/aws/aws-cdk).
 
 ## Table of Contents
 1. [About this Repo](#About)
@@ -35,8 +35,9 @@ While this is an excellent learning resource for the CDK, there are other resour
 ### Official Resources
 - [Developer Guide](https://docs.aws.amazon.com/cdk/latest/guide/home.html)
 - [API Reference](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-construct-library.html)
-- [CDK Workshop](https://cdkworkshop.com/)
 - [CDK Repository](https://github.com/aws/aws-cdk)
+- [CDK Construct Hub](https://constructs.dev/)
+- [CDK Workshop](https://cdkworkshop.com/)
 
 ### Unofficial/Community Resources
 - [AwesomeCDK](https://github.com/kolomied/awesome-cdk)