Updating the root README to add in new resources.

README.md

@@ -31,6 +31,8 @@ For more information, see
 
 ### Design Patterns
 
+- [How Google does it: Your guide to platform
+  engineering][guide-to-platform-eng]
 - [Platform Engineering: 5 Implemenation Myths][myths-webinar]
 - [Business continuity planning for CI/CD][cicd-business-continuity]
 
@@ -45,7 +47,9 @@ For more information, see
 
 #### Manage Developer Environments at Scale
 
+- [Backstage on Google Cloud Quickstart][backstage-quickstart]
 - [Backstage Plugin for Cloud Workstations][backstage-cloudworkstations]
+- [Developer Sandboxes][sandboxes]
 
 #### Self-service and Automation patterns
 
@@ -60,6 +64,10 @@ For more information, see
 - [Integrate Cloud Deploy with enterprise change management
   systems][cloud-deploy-flow]
 
+#### Application migrations and modernization
+
+- [Acclerating application migrations][accelerating-migrations]
+
 ### End-to-end Examples
 
 - [Enterprise Application Blueprint][enterprise-app-blueprint] - Deploys an
@@ -96,10 +104,14 @@ Copyright 2024 Google LLC Code in this repository is licensed under the Apache
 
 <!-- LINKS: https://www.markdownguide.org/basic-syntax/#reference-style-links -->
 
+[accelerating-migrations]:
+    ./reference-architectures/accelerating-migrations/README.md
 [automatic-password-rotation]:
     ./reference-architectures/automated-password-rotation/README.md
 [backstage-cloudworkstations]:
     https://github.com/googlecloudplatform/google-cloud-backstage-plugins
+[backstage-quickstart]:
+    ./reference-architectures/backstage/backstage-quickstart/README.md
 [cicd-business-continuity]:
     https://cloud.google.com/architecture/business-continuity-with-cicd-on-google-cloud
 [enterprise-app-blueprint]:
@@ -111,7 +123,10 @@ Copyright 2024 Google LLC Code in this repository is licensed under the Apache
 [esg-platform-engineering-webinar]:
     https://cloudonair.withgoogle.com/events/mastering-platform-engineering-key-insights-from-industry-experts
 [github-runners-gke]: ./reference-architectures/github-runners-gke/README.md
+[guide-to-platform-eng]:
+    https://cloud.google.com/blog/products/application-modernization/a-guide-to-platform-engineering
 [cloud-deploy-flow]: ./reference-architectures/cloud_deploy_flow/README.md
 [myths-webinar]: https://www.youtube.com/watch?v=jDBOiYvXVZI&t=2s
+[sandboxes]: ./reference-architectures/sandboxes/README.md
 [software-delivery-blueprint]:
     https://github.com/GoogleCloudPlatform/software-delivery-blueprint

docs/index.html

@@ -361,6 +361,15 @@
     </span>
   </a>
 
+</li>
+
+          <li class="md-nav__item">
+  <a href="#application-migrations-and-modernization" class="md-nav__link">
+    <span class="md-ellipsis">
+      Application migrations and modernization
+    </span>
+  </a>
+
 </li>
 
       </ul>
@@ -1716,6 +1725,15 @@
     </span>
   </a>
 
+</li>
+
+          <li class="md-nav__item">
+  <a href="#application-migrations-and-modernization" class="md-nav__link">
+    <span class="md-ellipsis">
+      Application migrations and modernization
+    </span>
+  </a>
+
 </li>
 
       </ul>
@@ -1808,6 +1826,8 @@ <h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanen
 <h2 id="resources">Resources<a class="headerlink" href="#resources" title="Permanent link">&para;</a></h2>
 <h3 id="design-patterns">Design Patterns<a class="headerlink" href="#design-patterns" title="Permanent link">&para;</a></h3>
 <ul>
+<li><a href="https://cloud.google.com/blog/products/application-modernization/a-guide-to-platform-engineering">How Google does it: Your guide to platform
+  engineering</a></li>
 <li><a href="https://www.youtube.com/watch?v=jDBOiYvXVZI&amp;t=2s">Platform Engineering: 5 Implemenation Myths</a></li>
 <li><a href="https://cloud.google.com/architecture/business-continuity-with-cicd-on-google-cloud">Business continuity planning for CI/CD</a></li>
 </ul>
@@ -1821,7 +1841,9 @@ <h3 id="research-papers-and-white-papers">Research papers and white papers<a cla
 <h3 id="guides-and-building-blocks">Guides and Building Blocks<a class="headerlink" href="#guides-and-building-blocks" title="Permanent link">&para;</a></h3>
 <h4 id="manage-developer-environments-at-scale">Manage Developer Environments at Scale<a class="headerlink" href="#manage-developer-environments-at-scale" title="Permanent link">&para;</a></h4>
 <ul>
+<li><a href="reference-architectures/backstage/backstage-quickstart/">Backstage on Google Cloud Quickstart</a></li>
 <li><a href="https://github.com/googlecloudplatform/google-cloud-backstage-plugins">Backstage Plugin for Cloud Workstations</a></li>
+<li><a href="reference-architectures/sandboxes/">Developer Sandboxes</a></li>
 </ul>
 <h4 id="self-service-and-automation-patterns">Self-service and Automation patterns<a class="headerlink" href="#self-service-and-automation-patterns" title="Permanent link">&para;</a></h4>
 <ul>
@@ -1836,6 +1858,10 @@ <h4 id="enterprise-change-management">Enterprise change management<a class="head
 <li><a href="reference-architectures/cloud_deploy_flow/">Integrate Cloud Deploy with enterprise change management
   systems</a></li>
 </ul>
+<h4 id="application-migrations-and-modernization">Application migrations and modernization<a class="headerlink" href="#application-migrations-and-modernization" title="Permanent link">&para;</a></h4>
+<ul>
+<li><a href="reference-architectures/accelerating-migrations/">Acclerating application migrations</a></li>
+</ul>
 <h3 id="end-to-end-examples">End-to-end Examples<a class="headerlink" href="#end-to-end-examples" title="Permanent link">&para;</a></h3>
 <ul>
 <li><a href="https://github.com/GoogleCloudPlatform/terraform-google-enterprise-application">Enterprise Application Blueprint</a> - Deploys an

docs/reference-architectures/cloud_deploy_flow/WebsiteDemo/index.html

@@ -1653,8 +1653,8 @@ <h2 id="installation">Installation<a class="headerlink" href="#installation" tit
 <p>npm install</p>
 </li>
 <li>
-<p>Set your Google Cloud project ID and subscription names in the <code>index.js</code>
-    file.</p>
+<p>Create a <code>.env</code> file and populate it with the environment variables found in
+   <code>.env.sample</code></p>
 </li>
 <li>
 <p>Start the server:</p>

docs/reference-architectures/cloud_deploy_flow/index.html

@@ -1762,24 +1762,29 @@ <h2 id="gcp-services-enabled-by-terraform">GCP Services enabled by Terraform<a c
   event-driven functions.</li>
 <li><code>eventarc.googleapis.com</code>: Enables Eventarc for routing events from sources to
   targets.</li>
+<li><code>artifactregistry.googleapis.com</code>: Allows for image hosting for CI/CD.</li>
 </ul>
 <h2 id="getting-started">Getting Started<a class="headerlink" href="#getting-started" title="Permanent link">&para;</a></h2>
 <p>To run this demo, follow these steps:</p>
 <ol>
 <li>
-<p><strong>Fork and Clone the Repository</strong>: Start by forking this repository to your
-    GitHub account (So you can connect GCP to this repository), then clone it to
-    your local environment. After cloning, change your directory to the
+<p><strong>Fork and Clone the Repository</strong>: Start by forking <em>this</em> repository to
+    your GitHub account (So you can connect GCP to this repository), then clone
+    it to your local environment. After cloning, change your directory to the
     deployment demo:</p>
 <div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nb">cd</span><span class="w"> </span>platform-engineering/reference-architectures/cloud_deploy_flow
 </span></code></pre></div>
+<p>Note: you can't use a repository inside an Organization, just use your
+personal account for this demo.</p>
 </li>
 <li>
 <p><strong>Set Up Environment Variables or Variables File</strong>: You can set the
     necessary variables either by exporting them as environment variables or by
     creating a <code>terraform.tfvars</code> file. Refer to <code>variables.tf</code> for more details
     on each variable. Ensure the values match your Google Cloud project and
     GitHub configuration.</p>
+<p>For the repo-name and repo-owner here, use the repository you just cloned
+above.</p>
 <ul>
 <li>
 <p><strong>Option 1</strong>: Set environment variables manually in your shell:</p>

docs/sitemap.xml

@@ -2,78 +2,78 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/code-of-conduct/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/contributing/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/accelerating-migrations/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/automated-password-rotation/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/backstage/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/backstage/backstage-quickstart/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/cloud_deploy_flow/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/cloud_deploy_flow/CloudFunctions/cloudDeployApprovals/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/cloud_deploy_flow/CloudFunctions/cloudDeployInteractions/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/cloud_deploy_flow/CloudFunctions/cloudDeployOperations/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/cloud_deploy_flow/CloudFunctions/createRelease/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/cloud_deploy_flow/CloudRun/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/cloud_deploy_flow/WebsiteDemo/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/github-runners-gke/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/sandboxes/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/sandboxes/examples/cli/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/sandboxes/examples/gcp-sandboxes/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
     <url>
          <loc>https://googlecloudplatform.github.io/platform-engineering/reference-architectures/sandboxes/sandbox-modules/</loc>
-         <lastmod>2025-07-16</lastmod>
+         <lastmod>2025-08-13</lastmod>
     </url>
 </urlset>