Merge pull request #185 from buildpacks/document-platform

Add Platform documentation
buildpacks · Aug 19, 2020 · a3500a7 · a3500a7
1 parent e22a9d6
commit a3500a7
Show file tree

Hide file tree

Showing 61 changed files with 603 additions and 0 deletions.
diff --git a/categories/index.html b/categories/index.html
@@ -128,6 +128,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/app-developer-guide/build-an-app/index.html b/docs/app-developer-guide/build-an-app/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/app-developer-guide/environment-variables/index.html b/docs/app-developer-guide/environment-variables/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/app-developer-guide/index.html b/docs/app-developer-guide/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/app-developer-guide/specific-buildpacks/index.html b/docs/app-developer-guide/specific-buildpacks/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/app-journey/index.html b/docs/app-journey/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/buildpack-author-guide/create-buildpack/build-app/index.html b/docs/buildpack-author-guide/create-buildpack/build-app/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/buildpack-author-guide/create-buildpack/building-blocks-cnb/index.html b/docs/buildpack-author-guide/create-buildpack/building-blocks-cnb/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/buildpack-author-guide/create-buildpack/caching/index.html b/docs/buildpack-author-guide/create-buildpack/caching/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/buildpack-author-guide/create-buildpack/detection/index.html b/docs/buildpack-author-guide/create-buildpack/detection/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/buildpack-author-guide/create-buildpack/index.html b/docs/buildpack-author-guide/create-buildpack/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/buildpack-author-guide/create-buildpack/make-app-runnable/index.html b/docs/buildpack-author-guide/create-buildpack/make-app-runnable/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/buildpack-author-guide/create-buildpack/make-buildpack-configurable/index.html b/docs/buildpack-author-guide/create-buildpack/make-buildpack-configurable/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/buildpack-author-guide/create-buildpack/setup-local-environment/index.html b/docs/buildpack-author-guide/create-buildpack/setup-local-environment/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/buildpack-author-guide/index.html b/docs/buildpack-author-guide/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/buildpack-author-guide/package-a-buildpack/index.html b/docs/buildpack-author-guide/package-a-buildpack/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/concepts/components/builder/index.html b/docs/concepts/components/builder/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/concepts/components/buildpack/index.html b/docs/concepts/components/buildpack/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>

diff --git a/docs/concepts/components/index.html b/docs/concepts/components/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>
@@ -361,6 +364,18 @@ <h2><a href="https://buildpacks.io/docs/concepts/components/lifecycle/" class=""
 
 
 
+        <h2><a href="https://buildpacks.io/docs/concepts/components/platform/" class="">Platform</a></h2>
+        <p class="m-1"> A platform uses a lifecycle, buildpacks (packaged in a builder), and application source code to produce an OCI image.
+</p>
+
+
+          <div class="text-md-right">
+            <a class="small text-pink mr-md-3 text-decoration-none" href="https://buildpacks.io/docs/concepts/components/platform/">Learn more →</a>
+          </div>
+
+
+
+
         <h2><a href="https://buildpacks.io/docs/concepts/components/stack/" class="">Stack</a></h2>
         <p class="m-1"> A stack provides the buildpack lifecycle with build-time and run-time environments in the form of images.
 </p>

diff --git a/docs/concepts/components/index.xml b/docs/concepts/components/index.xml
@@ -40,6 +40,16 @@ application.&lt;/p&gt;</description>
 &lt;p&gt;The lifecycle orchestrates buildpack execution, then assembles the resulting artifacts into a final app image.&lt;/p&gt;</description>
     </item>
 
+    <item>
+      <title>Platform</title>
+      <link>https://buildpacks.io/docs/concepts/components/platform/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+      <guid>https://buildpacks.io/docs/concepts/components/platform/</guid>
+      <description>&lt;h2 id=&#34;what-is-a-platform&#34;&gt;What is a Platform?&lt;/h2&gt;
+&lt;p&gt;A &lt;code&gt;platform&lt;/code&gt; uses a &lt;a href=&#34;https://buildpacks.io/docs/concepts/components/lifecycle/&#34;&gt;lifecycle&lt;/a&gt;, &lt;a href=&#34;https://buildpacks.io/docs/concepts/components/buildpack/&#34;&gt;buildpacks&lt;/a&gt; (packaged in a &lt;a href=&#34;https://buildpacks.io/docs/concepts/components/builder/&#34;&gt;builder&lt;/a&gt;), and application source code to produce an OCI image.&lt;/p&gt;</description>
+    </item>
+
     <item>
       <title>Stack</title>
       <link>https://buildpacks.io/docs/concepts/components/stack/</link>

diff --git a/docs/concepts/components/lifecycle/index.html b/docs/concepts/components/lifecycle/index.html
@@ -130,6 +130,9 @@
       <li data-nav-id="/docs/concepts/components/lifecycle/" class="dd-item depth-2 active">
         <a href="/docs/concepts/components/lifecycle/">Lifecycle</a>
       </li>
+      <li data-nav-id="/docs/concepts/components/platform/" class="dd-item depth-2">
+        <a href="/docs/concepts/components/platform/">Platform</a>
+      </li>
       <li data-nav-id="/docs/concepts/components/stack/" class="dd-item depth-2">
         <a href="/docs/concepts/components/stack/">Stack</a>
       </li>