SEO optimizations for "Pulumi vs Cloud Templates" #2515
Conversation
@cnunciato optimized for KW: CloudFormation. I'm not sure how to create headers, but "What is Pulumi?", "What is CloudFormation?" and "The Pulumi Difference" were intended to be subheadings. If that's not possible they're also fine as they are.
![pulumi[bot]](https://avatars.githubusercontent.com/in/15540?s=60&v=4){kind=small}
There was a problem hiding this comment.
🍹 The Update (preview) for stack pulumi/www.pulumi.com/production was successful.
Resource Changes
Name Type Operation
>- default-vpc aws:ec2/vpc:Vpc read
~ archive-bucket-callback aws:lambda/function:Function update
>- default-vpc-public-1 aws:ec2/subnet:Subnet read
>- default-vpc-public-0 aws:ec2/subnet:Subnet read
* archive-handler aws:ecs/taskDefinition:TaskDefinition replaced
~ archive-bucket-subscription aws:s3/bucketNotification:BucketNotification update
|
Your site preview for commit 44935bf is now available! 🍹 http://content-bucket-8bec55f.s3-website-us-east-1.amazonaws.com Deploy previews powered by Pulumify |
| @@ -11,21 +10,25 @@ menu: | |||
| aliases: ["/docs/reference/vs/cloud_templates/"] | |||
| --- | |||
|
|
|||
| ## What is CloudFormation? | |||
There was a problem hiding this comment.
This heading doesn't work, as the content addresses ARM also. IMO we should just remove it.
| All major cloud providers offer their own form of infrastructure-as-"code" solution, typically by way of JSON or | ||
| YAML-based templating solutions. This includes AWS CloudFormation and Azure Resource Manager (ARM) templates. | ||
|
|
||
| These markup-based configuration files are often uploaded to a hosted service in the target cloud, where a hosted | ||
| service will then process the files to create, update, or delete resources as necessary. | ||
|
|
||
| Pulumi's model shares a lot with these systems. Although Pulumi programs are written in imperative, familiar languages, | ||
| they are ultimately evaluated to produce a similar set of create, update, or delete operations for your cloud resources. | ||
| ## The Pulumi Difference |
There was a problem hiding this comment.
Same with this one -- the phrase has an advertising-y ring to it and doesn't add much value, and since already seem to rank #1 for "difference between pulumi and cloudformation", presumably because of the "vs" in the title, so I'd suggest dropping this heading, too.
|
|
||
| This is where Pulumi begins to diverge from these other solutions, however. | ||
| Pulumi offers a multi-cloud alternative to more restrictive infrastructure-as-code template solutions, such as AWS CloudFormation. Pulumi allows you to streamline processes through managing resources from different platforms all in one place, using real code, in your favorite language. |
There was a problem hiding this comment.
| Pulumi offers a multi-cloud alternative to more restrictive infrastructure-as-code template solutions, such as AWS CloudFormation. Pulumi allows you to streamline processes through managing resources from different platforms all in one place, using real code, in your favorite language. | |
| Pulumi offers a multi-cloud alternative to more restrictive infrastructure-as-code template solutions like AWS CloudFormation. Pulumi allows you to streamline processes by managing resources from different platforms all in one place, using real code, in your favorite language. |
| This is where Pulumi begins to diverge from these other solutions, however. | ||
| Pulumi offers a multi-cloud alternative to more restrictive infrastructure-as-code template solutions, such as AWS CloudFormation. Pulumi allows you to streamline processes through managing resources from different platforms all in one place, using real code, in your favorite language. | ||
|
|
||
| Pulumi's model shares a lot with these systems. Although Pulumi programs are written in imperative, familiar languages, |
There was a problem hiding this comment.
This paragraph doesn't make sense wedged in where it is. It interrupts the flow between the second and fourth paragraphs, and is essentially saying the same thing as the fifth. We should reposition it, make it work, or remove it.
There was a problem hiding this comment.
Since it is redundant I opted to remove it. No reason to have redundant content IMO.
There was a problem hiding this comment.
🍹 The Update (preview) for stack pulumi/www.pulumi.com/production was successful.
Resource Changes
Name Type Operation
>- default-vpc-public-1 aws:ec2/subnet:Subnet read
>- default-vpc-public-0 aws:ec2/subnet:Subnet read
~ archive-bucket-callback aws:lambda/function:Function update
>- default-vpc aws:ec2/vpc:Vpc read
~ archive-bucket-subscription aws:s3/bucketNotification:BucketNotification update
* archive-handler aws:ecs/taskDefinition:TaskDefinition replaced
|
Your site preview for commit 4105442 is now available! 🍹 http://content-bucket-8bec55f.s3-website-us-east-1.amazonaws.com Deploy previews powered by Pulumify |
This PR is a continuation of #2376. This applies the suggested changes after 97th Floor did an initial optimization.