search

aws-samples / aws-cdk-examples

Example projects using the AWS CDK
Apache License 2.0
5.16k stars 2.17k forks source link

Exemplify use of core.Stage class #370

Open kastork opened 3 years ago

kastork commented 3 years ago

:rocket: Feature Request

General Information

Description

The term "Stage" is very overloaded across AWS services. CDK adds yet another stage in the form of @aws-cdk/core.Stage.

So far, the documentation for CDK doesn't say much about Stage or how it should be used in practice.

Proposed Solution

An example project in this repository that demonstrates good practice using Stage would be useful (along with better documentation in the API Docs.

Environment

Other information

NGL321 commented 3 years ago

Hey @kastork,

After a quick review, I agree that the documentation of Stage does not quite fully encapsulate the concept. With that said, I dont think that an example will resolve this problem though.

Could you give more details about what you think is missing/incomplete/unhelpful so we can work on improving it?

@Jerry-AWS any thoughts on this?

😸 😷

github-actions[bot] commented 3 years ago

This issue has not received a response in a while. If you want to keep this issue open, please leave a comment below and auto-close will be canceled.

kastork commented 3 years ago

I suppose I'm looking for a use-case. When would I use this construct and what does it buy me? The example would still be useful just to demonstrate how it is useful (IMO).