Merge pull request #664 from buildpacks/consolidate-common-concepts

Consolidate common concepts
buildpacks · Mar 8, 2024 · 9baa560 · 9baa560
1 parent 0540b5e
commit 9baa560
Show file tree

Hide file tree

Showing 216 changed files with 15,349 additions and 4,321 deletions.
diff --git a/categories/index.html b/categories/index.html
@@ -299,6 +299,14 @@
 <li data-nav-id="/docs/for-platform-operators/" class="dd-item depth-0 haschildren">
   <a href="/docs/for-platform-operators/">For Platform Operators</a>
   <ul class="ml-2">
+<li data-nav-id="/docs/for-platform-operators/tutorials/" class="dd-item depth-1 haschildren">
+  <a href="/docs/for-platform-operators/tutorials/">Tutorials</a>
+  <ul class="ml-2">
+<li data-nav-id="/docs/for-platform-operators/tutorials/lifecycle/" class="dd-item depth-2">
+  <a href="/docs/for-platform-operators/tutorials/lifecycle/">Orchestrate a build with the CNB lifecycle</a>
+</li>
+  </ul>
+</li>
 <li data-nav-id="/docs/for-platform-operators/concepts/" class="dd-item depth-1 haschildren">
   <a href="/docs/for-platform-operators/concepts/">Concepts</a>
   <ul class="ml-2">
@@ -337,16 +345,11 @@
 </li>
   </ul>
 </li>
-<li data-nav-id="/docs/for-platform-operators/concepts/dockerfiles/" class="dd-item depth-2 collapse">
-  <a href="/docs/for-platform-operators/concepts/dockerfiles/">What are image extensions?</a>
-</li>
-  </ul>
+<li data-nav-id="/docs/for-platform-operators/concepts/composite-buildpack/" class="dd-item depth-2 collapse">
+  <a href="/docs/for-platform-operators/concepts/composite-buildpack/">What is a composite buildpack?</a>
 </li>
-<li data-nav-id="/docs/for-platform-operators/tutorials/" class="dd-item depth-1 haschildren">
-  <a href="/docs/for-platform-operators/tutorials/">Tutorials</a>
-  <ul class="ml-2">
-<li data-nav-id="/docs/for-platform-operators/tutorials/lifecycle/" class="dd-item depth-2">
-  <a href="/docs/for-platform-operators/tutorials/lifecycle/">Orchestrate a build with the CNB lifecycle</a>
+<li data-nav-id="/docs/for-platform-operators/concepts/extension/" class="dd-item depth-2 collapse">
+  <a href="/docs/for-platform-operators/concepts/extension/">What is an image extension?</a>
 </li>
   </ul>
 </li>
@@ -673,6 +676,9 @@
 <li data-nav-id="/docs/for-buildpack-authors/concepts/" class="dd-item depth-1 haschildren">
   <a href="/docs/for-buildpack-authors/concepts/">Concepts</a>
   <ul class="ml-2">
+<li data-nav-id="/docs/for-buildpack-authors/concepts/buildpack/" class="dd-item depth-2 collapse">
+  <a href="/docs/for-buildpack-authors/concepts/buildpack/">What is a buildpack?</a>
+</li>
 <li data-nav-id="/docs/for-buildpack-authors/concepts/lifecycle-phases/" class="dd-item depth-2 collapse">
   <a href="/docs/for-buildpack-authors/concepts/lifecycle-phases/">What is the lifecycle?</a>
 </li>
@@ -694,6 +700,12 @@
 <li data-nav-id="/docs/for-buildpack-authors/concepts/component-buildpack/" class="dd-item depth-2 collapse">
   <a href="/docs/for-buildpack-authors/concepts/component-buildpack/">What is a component buildpack?</a>
 </li>
+<li data-nav-id="/docs/for-buildpack-authors/concepts/composite-buildpack/" class="dd-item depth-2 collapse">
+  <a href="/docs/for-buildpack-authors/concepts/composite-buildpack/">What is a composite buildpack?</a>
+</li>
+<li data-nav-id="/docs/for-buildpack-authors/concepts/extension/" class="dd-item depth-2 collapse">
+  <a href="/docs/for-buildpack-authors/concepts/extension/">What is an image extension?</a>
+</li>
 <li data-nav-id="/docs/for-buildpack-authors/concepts/build-plan/" class="dd-item depth-2 collapse">
   <a href="/docs/for-buildpack-authors/concepts/build-plan/">What is the build plan?</a>
 </li>
@@ -705,6 +717,15 @@
 <li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/" class="dd-item depth-2 collapse haschildren">
   <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/">Write buildpacks</a>
   <ul class="ml-2">
+<li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/get-started/" class="dd-item depth-3 collapse">
+  <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/get-started/">Get started</a>
+</li>
+<li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/use-build-plan/" class="dd-item depth-3 collapse">
+  <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/use-build-plan/">Use the build plan</a>
+</li>
+<li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/create-layer/" class="dd-item depth-3 collapse">
+  <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/create-layer/">Create dependency layers</a>
+</li>
 <li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/specify-launch-processes/" class="dd-item depth-3 collapse">
   <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/specify-launch-processes/">Specify process types</a>
 </li>
@@ -717,9 +738,6 @@
 <li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/clear-env/" class="dd-item depth-3 collapse">
   <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/clear-env/">Clear the buildpack environment</a>
 </li>
-<li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/create-layer/" class="dd-item depth-3 collapse">
-  <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/create-layer/">Create dependency layers</a>
-</li>
 <li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/create-slice-layers/" class="dd-item depth-3 collapse">
   <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/create-slice-layers/">Create slice layers</a>
 </li>
@@ -731,9 +749,6 @@
 </li>
 <li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/use-exec.d/" class="dd-item depth-3 collapse">
   <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/use-exec.d/">Use exec.d binaries to configure the application at runtime</a>
-</li>
-<li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/use-build-plan/" class="dd-item depth-3 collapse">
-  <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/use-build-plan/">Use the build plan</a>
 </li>
   </ul>
 </li>
@@ -756,6 +771,9 @@
 </li>
   </ul>
 </li>
+<li data-nav-id="/docs/for-buildpack-authors/how-to/distribute-buildpacks/craft-order/" class="dd-item depth-2 collapse">
+  <a href="/docs/for-buildpack-authors/how-to/distribute-buildpacks/craft-order/">Craft a buildpack order</a>
+</li>
 <li data-nav-id="/docs/for-buildpack-authors/how-to/migrate/" class="dd-item depth-2 collapse haschildren">
   <a href="/docs/for-buildpack-authors/how-to/migrate/">Migrate</a>
   <ul class="ml-2">
@@ -794,14 +812,17 @@
 <li data-nav-id="/docs/reference/config/" class="dd-item depth-1 collapse haschildren">
   <a href="/docs/reference/config/">Configuration</a>
   <ul class="ml-2">
+<li data-nav-id="/docs/reference/config/project-descriptor/" class="dd-item depth-2 collapse">
+  <a href="/docs/reference/config/project-descriptor/">project.toml</a>
+</li>
 <li data-nav-id="/docs/reference/config/builder-config/" class="dd-item depth-2 collapse">
   <a href="/docs/reference/config/builder-config/">builder.toml</a>
 </li>
+<li data-nav-id="/docs/reference/config/buildpack-config/" class="dd-item depth-2 collapse">
+  <a href="/docs/reference/config/buildpack-config/">buildpack.toml</a>
+</li>
 <li data-nav-id="/docs/reference/config/package-config/" class="dd-item depth-2 collapse">
   <a href="/docs/reference/config/package-config/">package.toml</a>
-</li>
-<li data-nav-id="/docs/reference/config/project-descriptor/" class="dd-item depth-2 collapse">
-  <a href="/docs/reference/config/project-descriptor/">project.toml</a>
 </li>
   </ul>
 </li>

diff --git a/docs/app-journey/index.html b/docs/app-journey/index.html
@@ -301,6 +301,14 @@
 <li data-nav-id="/docs/for-platform-operators/" class="dd-item depth-0 haschildren">
   <a href="/docs/for-platform-operators/">For Platform Operators</a>
   <ul class="ml-2">
+<li data-nav-id="/docs/for-platform-operators/tutorials/" class="dd-item depth-1 haschildren">
+  <a href="/docs/for-platform-operators/tutorials/">Tutorials</a>
+  <ul class="ml-2">
+<li data-nav-id="/docs/for-platform-operators/tutorials/lifecycle/" class="dd-item depth-2">
+  <a href="/docs/for-platform-operators/tutorials/lifecycle/">Orchestrate a build with the CNB lifecycle</a>
+</li>
+  </ul>
+</li>
 <li data-nav-id="/docs/for-platform-operators/concepts/" class="dd-item depth-1 haschildren">
   <a href="/docs/for-platform-operators/concepts/">Concepts</a>
   <ul class="ml-2">
@@ -339,16 +347,11 @@
 </li>
   </ul>
 </li>
-<li data-nav-id="/docs/for-platform-operators/concepts/dockerfiles/" class="dd-item depth-2 collapse">
-  <a href="/docs/for-platform-operators/concepts/dockerfiles/">What are image extensions?</a>
-</li>
-  </ul>
+<li data-nav-id="/docs/for-platform-operators/concepts/composite-buildpack/" class="dd-item depth-2 collapse">
+  <a href="/docs/for-platform-operators/concepts/composite-buildpack/">What is a composite buildpack?</a>
 </li>
-<li data-nav-id="/docs/for-platform-operators/tutorials/" class="dd-item depth-1 haschildren">
-  <a href="/docs/for-platform-operators/tutorials/">Tutorials</a>
-  <ul class="ml-2">
-<li data-nav-id="/docs/for-platform-operators/tutorials/lifecycle/" class="dd-item depth-2">
-  <a href="/docs/for-platform-operators/tutorials/lifecycle/">Orchestrate a build with the CNB lifecycle</a>
+<li data-nav-id="/docs/for-platform-operators/concepts/extension/" class="dd-item depth-2 collapse">
+  <a href="/docs/for-platform-operators/concepts/extension/">What is an image extension?</a>
 </li>
   </ul>
 </li>
@@ -675,6 +678,9 @@
 <li data-nav-id="/docs/for-buildpack-authors/concepts/" class="dd-item depth-1 haschildren">
   <a href="/docs/for-buildpack-authors/concepts/">Concepts</a>
   <ul class="ml-2">
+<li data-nav-id="/docs/for-buildpack-authors/concepts/buildpack/" class="dd-item depth-2 collapse">
+  <a href="/docs/for-buildpack-authors/concepts/buildpack/">What is a buildpack?</a>
+</li>
 <li data-nav-id="/docs/for-buildpack-authors/concepts/lifecycle-phases/" class="dd-item depth-2 collapse">
   <a href="/docs/for-buildpack-authors/concepts/lifecycle-phases/">What is the lifecycle?</a>
 </li>
@@ -696,6 +702,12 @@
 <li data-nav-id="/docs/for-buildpack-authors/concepts/component-buildpack/" class="dd-item depth-2 collapse">
   <a href="/docs/for-buildpack-authors/concepts/component-buildpack/">What is a component buildpack?</a>
 </li>
+<li data-nav-id="/docs/for-buildpack-authors/concepts/composite-buildpack/" class="dd-item depth-2 collapse">
+  <a href="/docs/for-buildpack-authors/concepts/composite-buildpack/">What is a composite buildpack?</a>
+</li>
+<li data-nav-id="/docs/for-buildpack-authors/concepts/extension/" class="dd-item depth-2 collapse">
+  <a href="/docs/for-buildpack-authors/concepts/extension/">What is an image extension?</a>
+</li>
 <li data-nav-id="/docs/for-buildpack-authors/concepts/build-plan/" class="dd-item depth-2 collapse">
   <a href="/docs/for-buildpack-authors/concepts/build-plan/">What is the build plan?</a>
 </li>
@@ -707,6 +719,15 @@
 <li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/" class="dd-item depth-2 collapse haschildren">
   <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/">Write buildpacks</a>
   <ul class="ml-2">
+<li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/get-started/" class="dd-item depth-3 collapse">
+  <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/get-started/">Get started</a>
+</li>
+<li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/use-build-plan/" class="dd-item depth-3 collapse">
+  <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/use-build-plan/">Use the build plan</a>
+</li>
+<li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/create-layer/" class="dd-item depth-3 collapse">
+  <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/create-layer/">Create dependency layers</a>
+</li>
 <li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/specify-launch-processes/" class="dd-item depth-3 collapse">
   <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/specify-launch-processes/">Specify process types</a>
 </li>
@@ -719,9 +740,6 @@
 <li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/clear-env/" class="dd-item depth-3 collapse">
   <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/clear-env/">Clear the buildpack environment</a>
 </li>
-<li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/create-layer/" class="dd-item depth-3 collapse">
-  <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/create-layer/">Create dependency layers</a>
-</li>
 <li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/create-slice-layers/" class="dd-item depth-3 collapse">
   <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/create-slice-layers/">Create slice layers</a>
 </li>
@@ -733,9 +751,6 @@
 </li>
 <li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/use-exec.d/" class="dd-item depth-3 collapse">
   <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/use-exec.d/">Use exec.d binaries to configure the application at runtime</a>
-</li>
-<li data-nav-id="/docs/for-buildpack-authors/how-to/write-buildpacks/use-build-plan/" class="dd-item depth-3 collapse">
-  <a href="/docs/for-buildpack-authors/how-to/write-buildpacks/use-build-plan/">Use the build plan</a>
 </li>
   </ul>
 </li>
@@ -758,6 +773,9 @@
 </li>
   </ul>
 </li>
+<li data-nav-id="/docs/for-buildpack-authors/how-to/distribute-buildpacks/craft-order/" class="dd-item depth-2 collapse">
+  <a href="/docs/for-buildpack-authors/how-to/distribute-buildpacks/craft-order/">Craft a buildpack order</a>
+</li>
 <li data-nav-id="/docs/for-buildpack-authors/how-to/migrate/" class="dd-item depth-2 collapse haschildren">
   <a href="/docs/for-buildpack-authors/how-to/migrate/">Migrate</a>
   <ul class="ml-2">
@@ -796,14 +814,17 @@
 <li data-nav-id="/docs/reference/config/" class="dd-item depth-1 collapse haschildren">
   <a href="/docs/reference/config/">Configuration</a>
   <ul class="ml-2">
+<li data-nav-id="/docs/reference/config/project-descriptor/" class="dd-item depth-2 collapse">
+  <a href="/docs/reference/config/project-descriptor/">project.toml</a>
+</li>
 <li data-nav-id="/docs/reference/config/builder-config/" class="dd-item depth-2 collapse">
   <a href="/docs/reference/config/builder-config/">builder.toml</a>
 </li>
+<li data-nav-id="/docs/reference/config/buildpack-config/" class="dd-item depth-2 collapse">
+  <a href="/docs/reference/config/buildpack-config/">buildpack.toml</a>
+</li>
 <li data-nav-id="/docs/reference/config/package-config/" class="dd-item depth-2 collapse">
   <a href="/docs/reference/config/package-config/">package.toml</a>
-</li>
-<li data-nav-id="/docs/reference/config/project-descriptor/" class="dd-item depth-2 collapse">
-  <a href="/docs/reference/config/project-descriptor/">project.toml</a>
 </li>
   </ul>
 </li>

diff --git a/docs/concepts/components/buildpack/index.html b/docs/concepts/components/buildpack/index.html
diff --git a/docs/features/dockerfiles/index.html b/docs/features/dockerfiles/index.html
@@ -1,10 +1,10 @@
 <!DOCTYPE html>
 <html lang="en-us">
   <head>
-    <title>https://buildpacks.io/docs/for-platform-operators/concepts/dockerfiles/</title>
-    <link rel="canonical" href="https://buildpacks.io/docs/for-platform-operators/concepts/dockerfiles/">
+    <title>https://buildpacks.io/docs/for-platform-operators/concepts/extension/</title>
+    <link rel="canonical" href="https://buildpacks.io/docs/for-platform-operators/concepts/extension/">
     <meta name="robots" content="noindex">
     <meta charset="utf-8">
-    <meta http-equiv="refresh" content="0; url=https://buildpacks.io/docs/for-platform-operators/concepts/dockerfiles/">
+    <meta http-equiv="refresh" content="0; url=https://buildpacks.io/docs/for-platform-operators/concepts/extension/">
   </head>
 </html>