Merge branch 'main' into non-root

buildpacks · Aug 19, 2020 · 02662e3 · 02662e3
2 parents 9a6388a + 489819d
commit 02662e3
Show file tree

Hide file tree

Showing 2 changed files with 35 additions and 3 deletions.
diff --git a/content/docs/concepts/components/platform.md b/content/docs/concepts/components/platform.md
@@ -0,0 +1,30 @@
++++
+title="Platform"
+weight=3
++++
+
+## What is a Platform?
+
+A `platform` uses a [lifecycle][lifecycle], [buildpacks][buildpack] (packaged in a [builder][builder]), and application source code to produce an OCI image.
+
+<!--more-->
+
+## Examples
+Examples of a platform might include:
+
+* A local CLI tool that uses buildpacks to create OCI images. One such tool is the [Pack CLI][pack]
+* A plugin for a continuous integration service that uses buildpacks to create OCI images. One such plugin is the [buildpacks][buildpacks-tekton] plugin in [Tekton][tekton]
+* A cloud application platform that uses buildpacks to build source code before deployment. One such platform is [kpack][kpack]
+
+## API
+The platform [specification][spec] details what a platform does, and how it interacts with lifecycles and builders. The current API version for the platform is `0.4`.
+
+[builder]: /docs/concepts/components/builder/
+[buildpack]: /docs/concepts/components/buildpack/
+[lifecycle]: /docs/concepts/components/lifecycle/
+[spec]: https://github.com/buildpacks/spec/blob/main/platform.md
+[pack]: https://github.com/buildpacks/pack
+[buildpacks-tekton]: https://github.com/tektoncd/catalog/tree/master/task/buildpacks
+[tekton]: https://tekton.dev/
+[kpack]: https://github.com/pivotal/kpack
+[api-version]: https://github.com/buildpacks/spec/blob/main/platform.md#platform-api-version
diff --git a/content/docs/install-pack.md b/content/docs/install-pack.md
@@ -14,9 +14,9 @@ You can install the most recent version of `pack` (version **{{< latest >}}**) a
 * [Linux](#linux)
 * [Windows](#windows)
 
-### macOS
+### Homebrew on macOS and Linux
 
-To install `pack` on macOS, the easiest way is to use Homebrew:
+To install `pack` on macOS and Linux, the easiest way is to use Homebrew:
 
 ```bash
 brew install buildpacks/tap/pack
@@ -26,7 +26,9 @@ brew install buildpacks/tap/pack
 
 <hr/>
 
-### Linux
+### Alternative installation on Linux
+
+`pack` is available on GitHub releases so you can directly get and install it.
 
 ```bash
 wget https://github.com/buildpacks/pack/releases/download/v{{< latest >}}/pack-v{{< latest >}}-linux.tgz