Move content to operators how-to

Signed-off-by: Natalie Arellano <[email protected]>

Author: Natalie Arellano

content/docs/_index.md

@@ -25,7 +25,7 @@ Set of guides tailored to specific personas:
 
 *  [App Developers](/docs/app-developer-guide/)
 *  [Buildpack Authors](/docs/buildpack-author-guide/)
-*  [Operators](/docs/operator-guide/)
+*  [Operators](/docs/for-platform-operators/)
 
 ## [Tools](/docs/tools/)
 

content/docs/concepts/components/builder.md

@@ -27,6 +27,6 @@ A builder consists of the following components:
 To learn how to create your own builder, see our [Operator's Guide][operator-guide].
 
 [builder-config]: /docs/reference/builder-config/
-[operator-guide]: /docs/operator-guide/
+[operator-guide]: /docs/for-platform-operators/
 [buildpack]: /docs/concepts/components/buildpack/
 [lifecycle]: /docs/concepts/components/lifecycle/

content/docs/concepts/components/buildpack-group.md

@@ -50,6 +50,6 @@ 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/operator-guide/
+[operator-guide]: /docs/for-platform-operators/
 [builder]: /docs/concepts/components/builder/
 [meta-buildpack]: /docs/concepts/components/buildpack/#meta-buildpack

content/docs/concepts/components/stack.md

@@ -52,7 +52,7 @@ 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/operator-guide/
+[operator-guide]: /docs/for-platform-operators/
 [builder]: /docs/concepts/components/builder/
 [buildpack]: /docs/concepts/components/buildpack/
 [lifecycle]: /docs/concepts/components/lifecycle/

content/docs/operator-guide/create-build-base.md renamed to content/docs/for-platform-operators/how-to/create-build-base.md

@@ -3,6 +3,8 @@ title="Create a build base image"
 weight=2
 +++
 
+<!--more-->
+
 ## Define a build base image for your CNB build
 
 We need a Dockerfile similar to the following:

content/docs/operator-guide/create-a-builder.md renamed to content/docs/for-platform-operators/how-to/create-builder.md

@@ -3,7 +3,8 @@ title="Create a builder"
 weight=1
 +++
 
-Creating a custom [builder][builder] allows you to control what buildpacks are used and what image apps are based on.
+A [builder][builder] is an OCI image with all the inputs needed for a buildpacks build, including 
+the build-time base image, a reference to a runtime base image, a lifecycle, and a set of buildpacks.
 
 <!--more-->
 

content/docs/operator-guide/create-run-base.md renamed to content/docs/for-platform-operators/how-to/create-run-base.md

@@ -3,6 +3,8 @@ title="Create a run base image"
 weight=3
 +++
 
+<!--more-->
+
 ## Define a run base image for your CNB build
 
 We need a Dockerfile similar to the following:

content/docs/operator-guide/create-a-stack.md renamed to content/docs/for-platform-operators/how-to/create-stack.md

@@ -3,10 +3,12 @@ title="Create a stack"
 weight=4
 +++
 
+<!--more-->
+
 **Note**: As of Platform API 0.12 and Buildpack API 0.10, stacks are deprecated in favor of existing constructs in the container image ecosystem such as operating system name, operating system distribution, and architecture.
 
 You can still configure the build and run base images for your CNB build.
-To find out how, see [create a build base image](/docs/operator-guide/create-build-base/) and [create a run base image](/docs/operator-guide/create-run-base/).
+To find out how, see [create a build base image](/docs/for-platform-operators/how-to/create-build-base/) and [create a run base image](/docs/for-platform-operators/how-to/create-run-base/).
 
 A stack is the grouping together of the build and run base images, represented by a unique ID.
 A stack ID identifies the configuration for the build and run base images, and it used to determined compatibility with available buildpacks, and rebasability when updated run images are available.
@@ -24,7 +26,7 @@ Before we get started, make sure you've got the following installed:
 ## Creating a custom stack
 
 We will create a sample stack based on `Ubuntu Jammy Jellyfish`. To create a custom stack, we need to create customized build and run images.
-To find out how, see [create a build base image](/docs/operator-guide/create-build-base/) and [create a run base image](/docs/operator-guide/create-run-base/), then come back here.
+To find out how, see [create a build base image](/docs/for-platform-operators/how-to/create-build-base/) and [create a run base image](/docs/for-platform-operators/how-to/create-run-base/), then come back here.
 
 ## Choose your stack ID