Alternative take on pulumi-cloud.md

content/docs/deployments/get-started/_index.md

@@ -16,7 +16,7 @@ Pulumi Cloud is a managed service that provides state management, secrets handli
 
 ## Is Pulumi Cloud right for you?
 
-New to Pulumi or evaluating your options? Read [Pulumi Cloud and Open Source Pulumi](./what-is-it/) to understand:
+New to Pulumi or evaluating your options? Read [Pulumi Cloud and Open Source Pulumi](/docs/iac/concepts/pulumi-cloud/) to understand:
 
 - How Pulumi Cloud relates to the open source Pulumi IaC tool
 - The tradeoffs between using Pulumi Cloud versus self-managed backends

content/docs/iac/concepts/_index.md

@@ -28,7 +28,7 @@ If this is your first time using Pulumi, you likely want to begin with [the Gett
 
 Pulumi is an [infrastructure as code](/what-is/what-is-infrastructure-as-code/) platform that allows you to use familiar programming languages and tools to build, deploy, and manage cloud infrastructure.
 
-Pulumi is free, [open source](https://github.com/pulumi/pulumi), and optionally pairs with the [Pulumi Cloud](https://www.pulumi.com/docs/pulumi-cloud/) to make managing infrastructure secure, reliable, and hassle-free.
+Pulumi is free, [open source](https://github.com/pulumi/pulumi), and optionally pairs with [Pulumi Cloud](/docs/iac/concepts/pulumi-cloud/) to make managing infrastructure secure, reliable, and hassle-free.
 
 ## Supported languages and SDKs
 
@@ -51,7 +51,7 @@ The Pulumi platform comprises several components:
 
 - **Software development kit (SDK)**: Pulumi Software Development Kit (SDK) provides bindings for each type of resource that the provider can manage. This provides the necessary tools and libraries for defining and managing cloud resources on any cloud and with any provider.
 
-- **Command-Line interface (CLI)**: Pulumi is controlled primarily using the command line interface [(CLI)](https://www.pulumi.com/docs/cli/). It works in conjunction with the [Pulumi Cloud](https://www.pulumi.com/docs/pulumi-cloud/) to deploy changes to your cloud apps and infrastructure. It keeps a history of who updated what in your team and when. This CLI has been designed for great inner loop productivity, in addition to continuous integration and delivery scenarios.
+- **Command-Line interface (CLI)**: Pulumi is controlled primarily using the command line interface [(CLI)](https://www.pulumi.com/docs/cli/). It works in conjunction with [Pulumi Cloud](/docs/iac/concepts/pulumi-cloud/) to deploy changes to your cloud apps and infrastructure. It keeps a history of who updated what in your team and when. This CLI has been designed for great inner loop productivity, in addition to continuous integration and delivery scenarios.
 
 - **Deployment engine** The deployment engine is responsible for computing the set of operations needed to drive the current state of your infrastructure into the desired state expressed by your program.
 
@@ -77,78 +77,86 @@ Finally, the server's resulting IP address and DNS name are exported as stack ou
 
 The following topics provide more details on the core concepts of Pulumi and how to use it:
 
-<!-- how & projects -->
+<!-- how & pulumi cloud -->
 <div class="md:flex flex-row mt-6 mb-6">
     <div class="md:w-1/2 border-solid md:ml-4 border-t-2 border-gray-200">
-        <h3 class="no-anchor pt-4"><a href="/docs/concepts/how-pulumi-works"><i class="fas fa-laptop-code pr-2"></i>How Pulumi works</a></h3>
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/how-pulumi-works"><i class="fas fa-laptop-code pr-2"></i>How Pulumi works</a></h3>
         <p>Learn about how Pulumi performs deployments under the hood.</p>
     </div>
     <div class="md:w-1/2 border-solid border-t-2 border-gray-200">
-        <h3 class="no-anchor pt-4"><a href="/docs/concepts/projects"><i class="fas fa-folder-open pr-2"></i>Projects</a></h3>
-        <p>Learn how Pulumi projects are organized and configured.</p>
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/pulumi-cloud"><i class="fas fa-cloud-upload-alt pr-2"></i>Pulumi Cloud</a></h3>
+        <p>Learn how Pulumi Cloud relates to the open source tool and what it offers for teams.</p>
     </div>
 </div>
 
-<!-- stacks & resources -->
+<!-- projects & stacks -->
 <div class="md:flex flex-row mt-6 mb-6">
     <div class="md:w-1/2 border-solid md:ml-4 border-t-2 border-gray-200">
-        <h3 class="no-anchor pt-4"><a href="/docs/concepts/stack"><i class="fas fa-cloud pr-2"></i>Stacks</a></h3>
-        <p>Learn how to create and deploy stacks.</p>
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/projects"><i class="fas fa-folder-open pr-2"></i>Projects</a></h3>
+        <p>Learn how Pulumi projects are organized and configured.</p>
     </div>
     <div class="md:w-1/2 border-solid border-t-2 border-gray-200">
-        <h3 class="no-anchor pt-4"><a href="/docs/concepts/resources"><i class="fas fa-server pr-2"></i>Resources</a></h3>
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/stack"><i class="fas fa-layer-group pr-2"></i>Stacks</a></h3>
+        <p>Learn how to create and deploy stacks.</p>
+    </div>
+</div>
+
+<!-- resources -->
+<div class="md:flex flex-row mt-6 mb-6">
+    <div class="md:w-1/2 border-solid md:ml-4 border-t-2 border-gray-200">
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/resources"><i class="fas fa-server pr-2"></i>Resources</a></h3>
         <p>Learn more about how to use and manage resources in your programs.</p>
     </div>
 </div>
 
 <!-- resource options & inputs/outputs -->
 <div class="md:flex flex-row mt-6 mb-6">
     <div class="md:w-1/2 border-solid md:ml-4 border-t-2 border-gray-200">
-        <h3 class="no-anchor pt-4"><a href="/docs/concepts/options"><i class="fas fa-swatchbook pr-2"></i>Resource options</a></h3>
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/options"><i class="fas fa-swatchbook pr-2"></i>Resource options</a></h3>
         <p>Learn more about how to use and manage resource options in your program.</p>
     </div>
     <div class="md:w-1/2 border-solid border-t-2 border-gray-200">
-        <h3 class="no-anchor pt-4"><a href="/docs/concepts/inputs-outputs"><i class="fas fa-file-import pr-2"></i>Inputs and outputs</a></h3>
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/inputs-outputs"><i class="fas fa-file-import pr-2"></i>Inputs and outputs</a></h3>
         <p>Learn how to use resource properties to handle dependencies between resources.</p>
     </div>
 </div>
 
 <!-- config & secrets -->
 <div class="md:flex flex-row mt-6 mb-6">
     <div class="md:w-1/2 border-solid md:ml-4 border-t-2 border-gray-200">
-        <h3 class="no-anchor pt-4"><a href="/docs/concepts/config"><i class="fas fa-toolbox pr-2"></i>Configuration</a></h3>
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/config"><i class="fas fa-toolbox pr-2"></i>Configuration</a></h3>
         <p>Learn how to configure stacks for different deployment scenarios.</p>
     </div>
     <div class="md:w-1/2 border-solid border-t-2 border-gray-200">
-        <h3 class="no-anchor pt-4"><a href="/docs/concepts/secrets"><i class="fas fa-key pr-2"></i>Secrets</a></h3>
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/secrets"><i class="fas fa-key pr-2"></i>Secrets</a></h3>
         <p>Learn how to handle sensitive data and how to store secret encrypted settings in Pulumi.</p>
     </div>
 </div>
 
 <!--  esc & state backends-->
 <div class="md:flex flex-row mt-6 mb-6">
     <div class="md:w-1/2 border-solid md:ml-4 border-t-2 border-gray-200">
-        <h3 class="no-anchor pt-4"><a href="/docs/concepts/environments"><i class="fas fa-cubes pr-2"></i>Environments (ESC)</a></h3>
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/environments"><i class="fas fa-cubes pr-2"></i>Environments (ESC)</a></h3>
         <p>Learn how to configure your deployment environments with Pulumi ESC.</p>
     </div>
      <div class="md:w-1/2 border-solid border-t-2 border-gray-200">
-        <h3 class="no-anchor pt-4"><a href="/docs/concepts/state"><i class="fas fa-file-alt pr-2"></i>State and backends</a></h3>
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/state"><i class="fas fa-file-alt pr-2"></i>State and backends</a></h3>
         <p>Learn how Pulumi stores state and manages concurrency.</p>
     </div>
 </div>
 
 <!-- logging & update plans -->
 <div class="md:flex flex-row mt-6 mb-6">
     <div class="md:w-1/2 border-solid border-t-2 border-gray-200">
-        <h3 class="no-anchor pt-4"><a href="/docs/concepts/update-plans"><i class="fas fa-upload pr-2"></i>Update plans</a></h3>
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/update-plans"><i class="fas fa-upload pr-2"></i>Update plans</a></h3>
         <p>Learn about how to constrain your deployments with update plans.</p>
     </div>
 </div>
 
 <!-- glossary & compare-->
 <div class="md:flex flex-row mt-6 mb-6">
     <div class="md:w-1/2 border-solid md:ml-4 border-t-2 border-gray-200">
-        <h3 class="no-anchor pt-4"><a href="/docs/concepts/glossary"><i class="fas fa-book pr-2"></i>Glossary</a></h3>
+        <h3 class="no-anchor pt-4"><a href="/docs/iac/concepts/glossary"><i class="fas fa-book pr-2"></i>Glossary</a></h3>
         <p>Look up definitions to commonly used terms.</p>
     </div>
     <div class="md:w-1/2 border-solid border-t-2 border-gray-200">