feat(doc): true-composable-templates #805
Conversation
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
ShaiBer
left a comment
ShaiBer
left a comment
There was a problem hiding this comment.
Hey, very nice piece!
My top level feedback is that I think that before the "Template Composition" section that talks about why Wing is preferable to templates, you should add a section that talks in general about the problems with templates
| a workshop. I told him that the audience was able to create a simple but powerful setup that | ||
| worked locally and was deployable on AWS using terraform. I noted that if I would have tried to | ||
| achieve this without Wing, it would have taken me two weeks to get to the same point. However, | ||
| the Product Manager offered a perspective that prompted deep reflection. He acknowledged the |
There was a problem hiding this comment.
In the first part where you describe the conversation with "the product manager" consider using a more personal and conversational tone. Maybe instead of "the product manager", give them a name and add some personal details about them. Make this feel a bit more intimate and less like a detached description of a conversation. If you give your friend a name, it will also make it less awkward down the story when you refer to them.
| developers to tweak them for specific needs. This layer would enable any developer to adapt the | ||
| template to their unique project requirements. | ||
|
|
||
| #### Why are we talking about Templates? |
There was a problem hiding this comment.
Maybe add a bunch of concrete examples and links to solutions from the platform engineering space
| working with it. Templates are a very powerful tool with a very appealing time to value, no wonder | ||
| this product manager asked about Wing vs a template on any technology. | ||
|
|
||
| #### Templates and Their Limits |
There was a problem hiding this comment.
| #### Templates and Their Limits | |
| #### What's wrong with templates? |
Maybe use a bit more conversational tone
| and innovation. They’re great for getting off the ground quickly but may not always cater to the | ||
| nuanced needs of every project. The ability to customize a template does introduce flexibility, | ||
| but this can also introduce complexity, requiring developers to navigate and manipulate the | ||
| template's constraints to suit their specific objectives. |
There was a problem hiding this comment.
The text feels a bit too abstract. Maybe lead with a concrete example
There was a problem hiding this comment.
One example I like to give is what happens if there's a security bug in the template and now we have to chase all copies of the template to fix this bug.
| but this can also introduce complexity, requiring developers to navigate and manipulate the | ||
| template's constraints to suit their specific objectives. | ||
|
|
||
| #### Template Composition |
There was a problem hiding this comment.
| #### Template Composition | |
| #### Composition instead of templates |
| It does know what is required in order to use itself with other resources. | ||
| The system identified this indirect composition of resource and call the onLift method of the Bedrock model with the callee as the host. | ||
|
|
||
| #### The Real Value of Using Wing |
| When a project grows, they grow outside the boundaries of what we initially thought should be the template version, | ||
| the project setup and architecture needs to allow developers to modify their architecture by allowing developers to refactor and change patterns in the way that fits the current business requirements. | ||
|
|
||
| ## Conclusion |
There was a problem hiding this comment.
Maybe add something personal here
Docs updates should not be submitted in this repository
Our doc site content is being automatically updated from Wing repository docs folder.
Please submit any changes to the docs as a PR here