Fix broken links

Natalie Arellano · Natalie Arellano · commit 2bb85cf13120 · 2024-02-13T15:49:25.000-05:00
Signed-off-by: Natalie Arellano &lt;narellano@vmware.com&gt;
diff --git a/content/community.md b/content/community.md
@@ -35,7 +35,7 @@ If you didn't find anything you'd like to improve while going through the tutori
 [talks]: /docs/#talks
 [tutorials]: /docs/#tutorials
 [spec]: /docs/reference/spec/
-[platforms]: /docs/concepts/components/platform/
+[platforms]: /docs/for-platform-operators/concepts/platform/
 [pack]: https://github.com/buildpacks/pack
 [lifecycle]: https://github.com/buildpacks/lifecycle
 [docs]: https://github.com/buildpacks/docs
diff --git a/content/docs/_index.md b/content/docs/_index.md
@@ -15,13 +15,9 @@ summary="Get started with Cloud Native Buildpacks."
 * [An App’s Brief Journey from Source to Image](/docs/app-journey/) - An easy-to-follow introduction to Cloud Native Buildpacks using `pack`, a command line tool for Cloud Native Buildpacks.
 * [Creating a Cloud Native Buildpack](/docs/buildpack-author-guide/create-buildpack) - Tutorial walking through the creation of a simple Ruby buildpack.
 
-## [Concepts](/docs/concepts)
+## Going deeper
 
-Learn the [concepts](/docs/concepts) of Cloud Native Buildpacks.
-
-## Guides
-
-Set of guides tailored to specific personas:
+See how-to guides, concepts, and advanced tutorials tailored to specific personas:
 
 *  [App Developers](/docs/for-app-developers/)
 *  [Buildpack Authors](/docs/for-buildpack-authors/)
diff --git a/content/docs/app-journey.md b/content/docs/app-journey.md
@@ -101,7 +101,7 @@ Windows image builds are now supported!
 
 <a href="/docs/for-app-developers/how-to/configure-build-environment/build-for-windows" class="button bg-blue">Windows build guide</a>
 
-[builder]: /docs/concepts/components/builder/
-[buildpack]: /docs/concepts/components/buildpack/
+[builder]: /docs/for-platform-operators/concepts/builder/
+[buildpack]: /docs/for-platform-operators/concepts/buildpack/
 [samples-java-maven]: https://github.com/buildpacks/samples/tree/main/apps/java-maven
 [pack-docs]: /docs/tools/pack/
diff --git a/content/docs/buildpack-author-guide/create-buildpack/building-blocks-cnb.md b/content/docs/buildpack-author-guide/create-buildpack/building-blocks-cnb.md
@@ -58,7 +58,7 @@ os = "linux"
 ```
 
 The buildpack ID is the way you will reference the buildpack when you create buildpack groups, builders, etc.
-[Targets](/docs/concepts/components/targets/) identifies the kind of build and run base images the buildpack will work with.
+[Targets](/docs/for-platform-operators/concepts/targets/) identifies the kind of build and run base images the buildpack will work with.
 The stack ID (deprecated) uniquely identifies a build and run image configuration the buildpack will work with. This example can be run on Ubuntu Jammy.
 
 ### `detect` and `build`
@@ -136,5 +136,5 @@ ERROR: failed to detect: buildpack(s) failed with err
 
 <a href="/docs/buildpack-author-guide/create-buildpack/detection" class="button bg-pink">Next Step</a>
 
-[builder]: /docs/concepts/components/builder
+[builder]: /docs/for-platform-operators/concepts/builder
 <!--+ end +-->
diff --git a/content/docs/concepts/components/_index.md b/content/docs/concepts/components/_index.md
diff --git a/content/docs/for-app-developers/concepts/buildpacks-basics/_index.md b/content/docs/for-app-developers/concepts/buildpacks-basics/_index.md
@@ -1,23 +1,23 @@
 +++
-title="Concepts"
-weight=3
+title="Buildpacks basics"
+weight=1
 expand=false
 +++
 
-<p class="lead">
-Buildpacks allow you to convert your source code into a secure, efficient, production ready container image.
-</p>
+Learn how buildpacks convert your application source code into a secure, efficient, production-ready container image.
+
+<!--more-->
 
 ## What are buildpacks?
 
-![buildpacks](/docs/concepts/what.svg)
+![buildpacks](/docs/for-app-developers/concepts/buildpacks-basics/what.svg)
 
-**[Buildpacks](/docs/concepts/components/buildpack) provide framework and runtime support for applications.** Buildpacks examine your apps to determine all the dependencies it needs and configure them appropriately to run on any cloud.
+**[Buildpacks](/docs/for-platform-operators/concepts/buildpack) provide framework and runtime support for applications.** Buildpacks examine your apps to determine all the dependencies it needs and configure them appropriately to run on any cloud.
 
 
 ## How do they work?
 
-![how](/docs/concepts/how.svg)
+![how](/docs/for-app-developers/concepts/buildpacks-basics/how.svg)
 
 **Each buildpack comprises of two phases -**
 
@@ -45,12 +45,12 @@ For example:
 
 ## What is a builder?
 
-![builder](/docs/concepts/builder.svg)
+![builder](/docs/for-app-developers/concepts/buildpacks-basics/builder.svg)
 
-[`Builders`](/docs/concepts/components/builder) are an ordered combination of [`buildpacks`](/docs/concepts/components/buildpack) with a base `build image`, a lifecycle, and reference to a `run image`.
+[`Builders`](/docs/for-platform-operators/concepts/builder) are an ordered combination of [`buildpacks`](/docs/for-platform-operators/concepts/buildpack) with a base `build image`, a lifecycle, and reference to a `run image`.
 They take in your `app` source code and build the output `app image`. The `build image` provides the base environment for the `builder` (for eg. an Ubuntu Bionic OS image with build tooling) and a `run image` provides the base environment for the `app image` during runtime.
 
-Under the hood a builder uses the [`lifecycle`](/docs/concepts/components/lifecycle) to run the `detect` phase for all the `buildpacks` it contains in order and then proceeds to run the `build` phase of all the `buildpacks` that passed detection.
+Under the hood a builder uses the [`lifecycle`](/docs/for-platform-operators/concepts/lifecycle) to run the `detect` phase for all the `buildpacks` it contains in order and then proceeds to run the `build` phase of all the `buildpacks` that passed detection.
 
 This allows us to have a **single** `builder` that can detect and build various kinds of applications automatically.
 
diff --git a/content/docs/for-app-developers/concepts/buildpacks-basics/builder.svg b/content/docs/for-app-developers/concepts/buildpacks-basics/builder.svg
diff --git a/content/docs/for-app-developers/concepts/buildpacks-basics/how.svg b/content/docs/for-app-developers/concepts/buildpacks-basics/how.svg
diff --git a/content/docs/for-app-developers/concepts/buildpacks-basics/what.svg b/content/docs/for-app-developers/concepts/buildpacks-basics/what.svg
diff --git a/content/docs/for-app-developers/concepts/buildpacks-operations/_index.md b/content/docs/for-app-developers/concepts/buildpacks-operations/_index.md
@@ -1,6 +1,5 @@
 +++
-title="Operations"
+title="Buildpacks operations"
 weight=2
 include_summaries=true
-expand=true
 +++
diff --git a/content/docs/for-app-developers/concepts/buildpacks-operations/build.md b/content/docs/for-app-developers/concepts/buildpacks-operations/build.md
@@ -6,13 +6,13 @@ summary="Build is the process of executing one or more buildpacks against the ap
 
 ## Building explained
 
-![build diagram](/docs/concepts/operations/build.svg)
+![build diagram](/docs/for-app-developers/concepts/buildpacks-operations/build.svg)
 
 {{< param "summary" >}} Each buildpack inspects the source code and provides relevant dependencies.
 An image is then generated from the app's source code and these dependencies.
 
-During the build process, the [build image](/docs/concepts/components/base-images/build/) becomes the environment in which buildpacks are executed,
-and the [run image](/docs/concepts/components/base-images/run/) becomes the base for the final app image.
+During the build process, the [build image](/docs/for-platform-operators/concepts/base-images/build/) becomes the environment in which buildpacks are executed,
+and the [run image](/docs/for-platform-operators/concepts/base-images/run/) becomes the base for the final app image.
 
-Buildpacks can be bundled together with a specific build image, resulting in a [builder](/docs/concepts/components/builder) image.
+Buildpacks can be bundled together with a specific build image, resulting in a [builder](/docs/for-platform-operators/concepts/builder) image.
 Builders provide a convenient way to distribute buildpacks.
diff --git a/content/docs/for-app-developers/concepts/buildpacks-operations/build.svg b/content/docs/for-app-developers/concepts/buildpacks-operations/build.svg
diff --git a/content/docs/for-app-developers/concepts/buildpacks-operations/rebase.md b/content/docs/for-app-developers/concepts/buildpacks-operations/rebase.md
@@ -11,7 +11,7 @@ aliases=[
 
 {{< param "summary" >}} By using image layer rebasing, this command avoids the need to fully rebuild the app.
 
-![rebase diagram](/docs/concepts/operations/rebase.svg)
+![rebase diagram](/docs/for-app-developers/concepts/buildpacks-operations/rebase.svg)
 
 At its core, image rebasing is a simple process. By inspecting an app image, `rebase` can determine whether or not a
 newer version of the app's base image exists (either locally or in a registry). If so, `rebase` updates the app image's
diff --git a/content/docs/for-app-developers/concepts/buildpacks-operations/rebase.svg b/content/docs/for-app-developers/concepts/buildpacks-operations/rebase.svg
diff --git a/content/docs/for-app-developers/concepts/reproducibility.md b/content/docs/for-app-developers/concepts/reproducibility.md
@@ -1,6 +1,6 @@
 +++
 title="Build reproducibility"
-weight=2
+weight=3
 +++
 
 Given the same inputs, two builds should produce the same outputs.
diff --git a/content/docs/for-app-developers/how-to/configure-build-environment/build-for-windows.md b/content/docs/for-app-developers/how-to/configure-build-environment/build-for-windows.md
@@ -130,9 +130,9 @@ curl http://10.0.0.1:8080
 [docker-env-vars]: https://docs.docker.com/engine/reference/commandline/cli/#environment-variables
 [docker-hosts]: #understanding-docker-hosts
 [build-linux]: /docs/for-app-developers/tutorials/basic-app
-[build]: /docs/concepts/operations/build
-[builder]: /docs/concepts/components/builder
-[buildpack]: /docs/concepts/components/buildpack
+[build]: /docs/for-app-developers/concepts/buildpacks-operations/build
+[builder]: /docs/for-platform-operators/concepts/builder
+[buildpack]: /docs/for-platform-operators/concepts/buildpack
 [samples]: https://github.com/buildpacks/samples
 [docker-general-settings]: https://docs.docker.com/docker-for-windows/#general
 [windows-openssh-server]: https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse
diff --git a/content/docs/for-app-developers/how-to/configure-build-environment/build-on-podman.md b/content/docs/for-app-developers/how-to/configure-build-environment/build-on-podman.md
@@ -64,7 +64,7 @@ Where:
 podman images
 ```
 
-[builder]: https://buildpacks.io/docs/concepts/components/builder/
+[builder]: https://buildpacks.io/docs/for-platform-operators/concepts/builder/
 
 ---
 
diff --git a/content/docs/for-app-developers/tutorials/basic-app/_index.md b/content/docs/for-app-developers/tutorials/basic-app/_index.md
@@ -1,6 +1,5 @@
 +++
 title="Build an application with buildpacks"
 weight=1
-expand=true
 include_summaries=true
 +++
diff --git a/content/docs/for-app-developers/tutorials/basic-app/build.md b/content/docs/for-app-developers/tutorials/basic-app/build.md
@@ -1,5 +1,5 @@
 +++
-title="Build an app"
+title="Build the app"
 weight=1
 summary="The basics of taking your app from source code to runnable image."
 aliases=[
@@ -84,7 +84,7 @@ Windows image builds are now supported!
 Check out the [Windows build guide](https://buildpacks.io/docs/for-app-developers/how-to/configure-build-environment/build-for-windows/).
 ` +-->
 
-[build]: /docs/concepts/operations/build
-[builder]: /docs/concepts/components/builder
-[buildpack]: /docs/concepts/components/buildpack
+[build]: /docs/for-app-developers/concepts/buildpacks-operations/build
+[builder]: /docs/for-platform-operators/concepts/builder
+[buildpack]: /docs/for-platform-operators/concepts/buildpack
 [samples]: https://github.com/buildpacks/samples
diff --git a/content/docs/for-app-developers/tutorials/basic-app/run.md b/content/docs/for-app-developers/tutorials/basic-app/run.md
@@ -1,6 +1,6 @@
 +++
-title="Specify launch process"
-weight=5
+title="Run the app"
+weight=2
 summary="Learn how to specify the launch process for an app."
 +++
 
diff --git a/content/docs/for-platform-operators/concepts/_index.md b/content/docs/for-platform-operators/concepts/_index.md
@@ -1,6 +1,7 @@
 +++
-title="Concepts"
-weight=2
-expand=false
+title="Components"
+weight=1
 include_summaries=true
-+++
+summaries_max_depth=1
+expand=true
++++
diff --git a/content/docs/for-platform-operators/concepts/base-images/build.md b/content/docs/for-platform-operators/concepts/base-images/build.md
diff --git a/content/docs/for-platform-operators/concepts/base-images/run.md b/content/docs/for-platform-operators/concepts/base-images/run.md
diff --git a/content/docs/for-platform-operators/concepts/builder.md b/content/docs/for-platform-operators/concepts/builder.md
@@ -11,22 +11,22 @@ aliases=[
 
 {{< param "summary" >}}
 
-![create-builder diagram](/docs/concepts/components/create-builder.svg)
+![create-builder diagram](/docs/for-platform-operators/concepts/create-builder.svg)
 
 ## Anatomy of a builder
 
 A builder consists of the following components:
 
 * [Buildpacks][buildpack]
 * A [lifecycle][lifecycle]
-* A [build image](/docs/concepts/components/base-images/build/)
-* A reference to a [run image](/docs/concepts/components/base-images/run/)
+* A [build image](/docs/for-platform-operators/concepts/base-images/build/)
+* A reference to a [run image](/docs/for-platform-operators/concepts/base-images/run/)
 
 ### Resources
 
 To learn how to create your own builder, see our [Operator's Guide][operator-guide].
 
 [builder-config]: /docs/reference/builder-config/
 [operator-guide]: /docs/for-platform-operators/
-[buildpack]: /docs/concepts/components/buildpack/
-[lifecycle]: /docs/concepts/components/lifecycle/
+[buildpack]: /docs/for-platform-operators/concepts/buildpack/
+[lifecycle]: /docs/for-platform-operators/concepts/lifecycle/
diff --git a/content/docs/for-platform-operators/concepts/buildpack-group.md b/content/docs/for-platform-operators/concepts/buildpack-group.md
@@ -51,5 +51,5 @@ The [Operator's Guide][operator-guide] has more information on creating builders
 [buildpack-group]: /docs/reference/config/builder-config/#order-_list-required_
 [order-resolution]: https://github.com/buildpacks/spec/blob/main/buildpack.md#order-resolution
 [operator-guide]: /docs/for-platform-operators/
-[builder]: /docs/concepts/components/builder/
-[meta-buildpack]: /docs/concepts/components/buildpack/#meta-buildpack
+[builder]: /docs/for-platform-operators/concepts/builder/
+[meta-buildpack]: /docs/for-platform-operators/concepts/buildpack/#meta-buildpack
diff --git a/content/docs/for-platform-operators/concepts/buildpack.md b/content/docs/for-platform-operators/concepts/buildpack.md
@@ -44,6 +44,6 @@ Buildpacks can be [packaged][package-a-buildpack] as OCI images on an image regi
 Learn more about buildpacks by referring to the [Buildpack API][buildpack-api]. 
 
 [buildpack-api]: /docs/reference/buildpack-api
-[buildpack-group]: /docs/concepts/components/buildpack-group/
+[buildpack-group]: /docs/for-platform-operators/concepts/buildpack-group/
 [package-a-buildpack]: /docs/for-buildpack-authors/how-to/distribute-buildpacks/package-buildpack/
-[platform]: /docs/concepts/components/platform
+[platform]: /docs/for-platform-operators/concepts/platform
diff --git a/content/docs/for-platform-operators/concepts/create-builder.svg b/content/docs/for-platform-operators/concepts/create-builder.svg
diff --git a/content/docs/for-platform-operators/concepts/platform.md b/content/docs/for-platform-operators/concepts/platform.md
@@ -23,9 +23,9 @@ The platform [specification][spec] details what a platform does, and how it inte
 
 For the latest version of the Platform API, see [releases][releases] on the spec repo.
 
-[builder]: /docs/concepts/components/builder/
-[buildpack]: /docs/concepts/components/buildpack/
-[lifecycle]: /docs/concepts/components/lifecycle/
+[builder]: /docs/for-platform-operators/concepts/builder/
+[buildpack]: /docs/for-platform-operators/concepts/buildpack/
+[lifecycle]: /docs/for-platform-operators/concepts/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
diff --git a/content/docs/for-platform-operators/concepts/stack.md b/content/docs/for-platform-operators/concepts/stack.md
@@ -15,9 +15,9 @@ As of Platform API 0.12 and Buildpack API 0.10, stacks are deprecated in favor o
 For more information, see
 * Platform API 0.12 [migration guide](/docs/for-platform-operators/how-to/migrate/platform-api-0.11-0.12/)
 * Buildpack API 0.10 [migration guide](/docs/for-buildpack-authors/how-to/migrate/buildpack-api-0.9-0.10/)
-* [Build image](/docs/concepts/components/base-images/build/) concept
-* [Run image](/docs/concepts/components/base-images/run/) concept
-* [Target data](/docs/concepts/components/targets/)
+* [Build image](/docs/for-platform-operators/concepts/base-images/build/) concept
+* [Run image](/docs/for-platform-operators/concepts/base-images/run/) concept
+* [Target data](/docs/for-platform-operators/concepts/targets/)
 
 For older API versions, see below on using stacks.
 
@@ -53,6 +53,6 @@ By providing the required `[stack]` section, a builder author can configure a st
 To learn how to create your own stack, see our [Operator's Guide][operator-guide].
 
 [operator-guide]: /docs/for-platform-operators/
-[builder]: /docs/concepts/components/builder/
-[buildpack]: /docs/concepts/components/buildpack/
-[lifecycle]: /docs/concepts/components/lifecycle/
+[builder]: /docs/for-platform-operators/concepts/builder/
+[buildpack]: /docs/for-platform-operators/concepts/buildpack/
+[lifecycle]: /docs/for-platform-operators/concepts/lifecycle/
diff --git a/content/docs/for-platform-operators/concepts/targets.md b/content/docs/for-platform-operators/concepts/targets.md
diff --git a/content/docs/for-platform-operators/how-to/declare-source-metadata.md b/content/docs/for-platform-operators/how-to/declare-source-metadata.md
@@ -142,5 +142,5 @@ type = "image"
   url = "https://github.com/example/repo"
 ```
 
-[lifecycle]: /docs/concepts/components/lifecycle/
+[lifecycle]: /docs/for-platform-operators/concepts/lifecycle/
 [project-metadata]: https://github.com/buildpacks/spec/blob/platform/0.7/platform.md#project-metadatatoml-toml
diff --git a/content/docs/for-platform-operators/how-to/integrate-ci/pack/_index.md b/content/docs/for-platform-operators/how-to/integrate-ci/pack/_index.md
@@ -76,7 +76,7 @@ go get -u github.com/buildpacks/pack
 - [Docs](https://pkg.go.dev/github.com/buildpacks/pack)
 - [Source](https://github.com/buildpacks/pack/)
 
-[build]: /docs/concepts/operations/build/
-[rebase]: /docs/concepts/operations/rebase/
-[components]: /docs/concepts/components/
+[build]: /docs/for-app-developers/concepts/buildpacks-operations/build/
+[rebase]: /docs/for-app-developers/concepts/buildpacks-operations/rebase/
+[components]: /docs/for-platform-operators/concepts/
 [github-releases]: https://github.com/buildpacks/pack/releases
diff --git a/content/docs/for-platform-operators/how-to/integrate-ci/tekton.md b/content/docs/for-platform-operators/how-to/integrate-ci/tekton.md
@@ -250,7 +250,7 @@ Some general resources for Tekton are:
 - [Tekton Authorization Documentation][tekton-auth]
 
 [tekton]: https://tekton.dev/
-[lifecycle]: /docs/concepts/components/lifecycle
+[lifecycle]: /docs/for-platform-operators/concepts/lifecycle
 [buildpacks-task]: https://github.com/tektoncd/catalog/tree/master/task/buildpacks
 [buildpacks-phases]: https://github.com/tektoncd/catalog/tree/master/task/buildpacks-phases
 [tekton-setup]: https://tekton.dev/docs/getting-started/
diff --git a/content/docs/for-platform-operators/how-to/migrate/deprecated/platform-api-0.5-0.6.md b/content/docs/for-platform-operators/how-to/migrate/deprecated/platform-api-0.5-0.6.md
@@ -31,4 +31,4 @@ Lifecycle exit codes are condensed to be within 0-255 so that they are understan
 
 The report.toml output by the exporter will now include the image manifest size in bytes. Note that this only applies to published images, as images exported to a docker daemon will not have a manifest.
 
-[lifecycle]: /docs/concepts/components/lifecycle/
+[lifecycle]: /docs/for-platform-operators/concepts/lifecycle/
diff --git a/content/docs/for-platform-operators/how-to/migrate/platform-api-0.11-0.12.md b/content/docs/for-platform-operators/how-to/migrate/platform-api-0.11-0.12.md
@@ -94,14 +94,14 @@ following the [rules](https://github.com/buildpacks/spec/blob/platform/v0.12/pla
 
 The feature is enabled by providing a `-layout` flag or by setting the `CNB_USE_LAYOUT` environment variable to `true` for the following lifecycle phases:
 
-- [Analyze](https://buildpacks.io/docs/concepts/components/lifecycle/analyze/)
-- [Restore](https://buildpacks.io/docs/concepts/components/lifecycle/restore/)
-- [Export](https://buildpacks.io/docs/concepts/components/lifecycle/export/)
-- [Create](https://buildpacks.io/docs/concepts/components/lifecycle/create/)
+- [Analyze](https://buildpacks.io/docs/for-platform-operators/concepts/lifecycle/analyze/)
+- [Restore](https://buildpacks.io/docs/for-platform-operators/concepts/lifecycle/restore/)
+- [Export](https://buildpacks.io/docs/for-platform-operators/concepts/lifecycle/export/)
+- [Create](https://buildpacks.io/docs/for-platform-operators/concepts/lifecycle/create/)
 
 Additionally, the path to the layout directory must be specified, either by providing a `-layout-dir` flag or by setting the `CNB_LAYOUT_DIR` environment variable.
 
-**Note**: [Rebasing](https://buildpacks.io/docs/concepts/components/lifecycle/rebase/) an image exported to OCI layout format
+**Note**: [Rebasing](https://buildpacks.io/docs/for-platform-operators/concepts/lifecycle/rebase/) an image exported to OCI layout format
 and extending OCI layout base images with Dockerfiles are currently not supported.
 
 ## Base Image Author
diff --git a/content/docs/for-platform-operators/how-to/prepare-build-inputs/build-base.md b/content/docs/for-platform-operators/how-to/prepare-build-inputs/build-base.md
@@ -60,7 +60,7 @@ The given user **MUST NOT** be a root user, and must have a writeable home direc
 
 Finally, we need to label the image with operating system distribution information for platforms and the lifecycle to use.
 
-To determine which values to provide, see [targets](/docs/concepts/components/targets/) concept information.
+To determine which values to provide, see [targets](/docs/for-platform-operators/concepts/targets/) concept information.
 
 ## Build the build base image
 
diff --git a/content/docs/for-platform-operators/how-to/prepare-build-inputs/builder.md b/content/docs/for-platform-operators/how-to/prepare-build-inputs/builder.md
@@ -105,7 +105,7 @@ For additional sample builders and buildpacks, check out our [samples][samples]
 
 You can also check out our reference of the builder config [here][builder-config].
 
-[build]: /docs/concepts/operations/build/
-[builder]: /docs/concepts/components/builder/
+[build]: /docs/for-app-developers/concepts/buildpacks-operations/build/
+[builder]: /docs/for-platform-operators/concepts/builder/
 [builder-config]: /docs/reference/builder-config/
 [samples]: https://github.com/buildpacks/samples
diff --git a/content/docs/for-platform-operators/how-to/prepare-build-inputs/run-base.md b/content/docs/for-platform-operators/how-to/prepare-build-inputs/run-base.md
@@ -51,7 +51,7 @@ You should consult the documentation for your buildpacks to determine what is su
 
 Finally, we need to label the image with operating system distribution information for platforms and the lifecycle to use.
 
-To determine which values to provide, see [targets](/docs/concepts/components/targets/) concept information.
+To determine which values to provide, see [targets](/docs/for-platform-operators/concepts/targets/) concept information.
 
 ## Build the run base image
 
diff --git a/content/docs/for-platform-operators/how-to/prepare-build-inputs/stack.md b/content/docs/for-platform-operators/how-to/prepare-build-inputs/stack.md
@@ -121,6 +121,6 @@ mixins = ["build:git", "run:imagemagick", "wget"]
 For technical details on stacks, see the stack sections in the [Platform](https://github.com/buildpacks/spec/blob/main/platform.md#iobuildpacksstack-labels)
 and [Buildpack](https://github.com/buildpacks/spec/blob/main/buildpack.md#buildpacktoml-toml-stacks-array) specifications.
 
-[stack]: /docs/concepts/components/stack/
-[builder]: /docs/concepts/components/builder/
+[stack]: /docs/for-platform-operators/concepts/stack/
+[builder]: /docs/for-platform-operators/concepts/builder/
 [samples]: https://github.com/buildpacks/samples
diff --git a/content/docs/for-platform-operators/tutorials/lifecycle/_index.md b/content/docs/for-platform-operators/tutorials/lifecycle/_index.md
@@ -1,5 +1,5 @@
 +++
-title="Orchestrate a build by invoking the lifecycle binary"
+title="Orchestrate a build with the CNB lifecycle"
 weight=1
 expand=true
 include_summaries=true
diff --git a/content/docs/reference/config/builder-config.md b/content/docs/reference/config/builder-config.md
diff --git a/content/docs/reference/config/package-config.md b/content/docs/reference/config/package-config.md
diff --git a/content/docs/reference/config/project-descriptor.md b/content/docs/reference/config/project-descriptor.md
diff --git a/content/docs/reference/spec/buildpack-api.md b/content/docs/reference/spec/buildpack-api.md
diff --git a/content/docs/reference/spec/platform-api.md b/content/docs/reference/spec/platform-api.md
