From 8641321bd33288a57aea49664dbbd44e5920bacf Mon Sep 17 00:00:00 2001 From: Aidan Delaney Date: Wed, 6 Dec 2023 10:57:48 +0000 Subject: [PATCH] Restructure App Developer Guide Use the structure described in RFC # and add some tests Signed-off-by: Aidan Delaney --- content/docs/app-developer-guide/_index.md | 4 +- .../docs/app-developer-guide/build-an-app.md | 61 +++++++++++++++++-- .../concepts/_index.md | 2 +- .../concepts}/builder.md | 0 .../concepts/builder.svg | 0 .../concepts}/buildpack.md | 0 .../concepts/components/_index.md | 0 .../concepts/components/base-images/build.md | 0 .../concepts/components/base-images/run.md | 0 .../concepts/components/buildpack-group.md | 0 .../concepts/components/create-builder.svg | 0 .../concepts/components/lifecycle/_index.md | 0 .../concepts/components/lifecycle/analyze.md | 0 .../concepts/components/lifecycle/build.md | 0 .../concepts/components/lifecycle/create.md | 0 .../concepts/components/lifecycle/detect.md | 0 .../concepts/components/lifecycle/export.md | 0 .../concepts/components/lifecycle/launch.md | 0 .../concepts/components/lifecycle/rebase.md | 0 .../concepts/components/lifecycle/restore.md | 0 .../concepts/components/stack.md | 0 .../concepts/how.svg | 0 .../concepts/operations/_index.md | 0 .../concepts/operations/build.md | 0 .../concepts/operations/build.svg | 0 .../concepts/operations/rebase.md | 0 .../concepts/operations/rebase.svg | 0 .../concepts}/platform.md | 0 .../concepts}/targets.md | 0 .../concepts/what.svg | 0 .../docs/app-developer-guide/how-to/_index.md | 5 ++ .../{ => how-to}/building-on-podman.md | 4 +- .../{ => how-to}/run-an-app.md | 0 .../{ => how-to}/specify-buildpacks.md | 0 .../{ => how-to}/using-cache-image.md | 0 .../using-environment-variables.md} | 2 +- .../{ => how-to}/using-http-proxy.md | 0 .../{ => how-to}/using-inline-buildpacks.md | 0 .../{ => how-to}/using-project-descriptor.md | 0 .../using-volumes.md} | 0 .../app-developer-guide/tutorials/_index.md | 5 ++ .../{ => tutorials}/build-a-windows-app.md | 4 +- .../{ => tutorials}/build-an-arm-app.md | 4 +- content/docs/buildpack-author-guide/_index.md | 2 +- content/docs/operator-guide/_index.md | 6 -- content/docs/platform-guide/_index.md | 4 +- .../create-a-builder.md | 0 .../create-a-stack.md | 0 .../create-build-base.md | 0 .../create-run-base.md | 0 50 files changed, 78 insertions(+), 25 deletions(-) rename content/docs/{ => app-developer-guide}/concepts/_index.md (99%) rename content/docs/{concepts/components => app-developer-guide/concepts}/builder.md (100%) rename content/docs/{ => app-developer-guide}/concepts/builder.svg (100%) rename content/docs/{concepts/components => app-developer-guide/concepts}/buildpack.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/_index.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/base-images/build.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/base-images/run.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/buildpack-group.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/create-builder.svg (100%) rename content/docs/{ => app-developer-guide}/concepts/components/lifecycle/_index.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/lifecycle/analyze.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/lifecycle/build.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/lifecycle/create.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/lifecycle/detect.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/lifecycle/export.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/lifecycle/launch.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/lifecycle/rebase.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/lifecycle/restore.md (100%) rename content/docs/{ => app-developer-guide}/concepts/components/stack.md (100%) rename content/docs/{ => app-developer-guide}/concepts/how.svg (100%) rename content/docs/{ => app-developer-guide}/concepts/operations/_index.md (100%) rename content/docs/{ => app-developer-guide}/concepts/operations/build.md (100%) rename content/docs/{ => app-developer-guide}/concepts/operations/build.svg (100%) rename content/docs/{ => app-developer-guide}/concepts/operations/rebase.md (100%) rename content/docs/{ => app-developer-guide}/concepts/operations/rebase.svg (100%) rename content/docs/{concepts/components => app-developer-guide/concepts}/platform.md (100%) rename content/docs/{concepts/components => app-developer-guide/concepts}/targets.md (100%) rename content/docs/{ => app-developer-guide}/concepts/what.svg (100%) create mode 100644 content/docs/app-developer-guide/how-to/_index.md rename content/docs/app-developer-guide/{ => how-to}/building-on-podman.md (98%) rename content/docs/app-developer-guide/{ => how-to}/run-an-app.md (100%) rename content/docs/app-developer-guide/{ => how-to}/specify-buildpacks.md (100%) rename content/docs/app-developer-guide/{ => how-to}/using-cache-image.md (100%) rename content/docs/app-developer-guide/{environment-variables.md => how-to/using-environment-variables.md} (99%) rename content/docs/app-developer-guide/{ => how-to}/using-http-proxy.md (100%) rename content/docs/app-developer-guide/{ => how-to}/using-inline-buildpacks.md (100%) rename content/docs/app-developer-guide/{ => how-to}/using-project-descriptor.md (100%) rename content/docs/app-developer-guide/{mounting-volumes.md => how-to/using-volumes.md} (100%) create mode 100644 content/docs/app-developer-guide/tutorials/_index.md rename content/docs/app-developer-guide/{ => tutorials}/build-a-windows-app.md (99%) rename content/docs/app-developer-guide/{ => tutorials}/build-an-arm-app.md (98%) delete mode 100644 content/docs/operator-guide/_index.md rename content/docs/{operator-guide => platform-guide}/create-a-builder.md (100%) rename content/docs/{operator-guide => platform-guide}/create-a-stack.md (100%) rename content/docs/{operator-guide => platform-guide}/create-build-base.md (100%) rename content/docs/{operator-guide => platform-guide}/create-run-base.md (100%) diff --git a/content/docs/app-developer-guide/_index.md b/content/docs/app-developer-guide/_index.md index 58a8fa60c..5ff6f150f 100644 --- a/content/docs/app-developer-guide/_index.md +++ b/content/docs/app-developer-guide/_index.md @@ -1,6 +1,6 @@ +++ -title="App Developer Guide" -weight=4 +title="For App Developers" +weight=1 include_summaries=true expand=true +++ diff --git a/content/docs/app-developer-guide/build-an-app.md b/content/docs/app-developer-guide/build-an-app.md index 1bac2ef93..e1a353960 100644 --- a/content/docs/app-developer-guide/build-an-app.md +++ b/content/docs/app-developer-guide/build-an-app.md @@ -10,8 +10,32 @@ aliases=[ # Build an app `+--> + + + + + + + + Building an app using Cloud Native Buildpacks is as easy as `1`, `2`, `3`... +## Prerequisites + +A lot of the examples used within this guide will require the following: + +{{< download-button href="https://store.docker.com/search?type=edition&offering=community" color="blue" >}} Install Docker {{}} +{{< download-button href="/docs/install-pack" color="pink" >}} Install pack {{}} + ### 1. Select a builder To [build][build] an app you must first decide which [builder][builder] you're going to use. A builder @@ -28,18 +52,22 @@ pack builder suggest For this guide we're actually going to use a sample builder, `cnbs/sample-builder:jammy`, which is not listed as a suggested builder for good reason. It's a sample. +> **TIP:** If you want to try production grade buildpacks, instead of our sample, use the `paketobuildpacks/builder:full` builder. Alternatively, if you intend to deploy your application on Google Cloud Run, use try the `Google` builder. If your intended platform is Heroku, use the `Heroku` builder. + ### 2. Build your app Now that you've decided on what builder to use, we can build our app. For this example we'll use our [samples][samples] repo for simplicity. 1. Check that the samples repo exists and if not - we clone it + ``` ls samples || git clone https://github.com/buildpacks/samples ``` 2. Build the app + ``` pack build sample-app --path samples/apps/java-maven --builder cnbs/sample-builder:jammy ``` @@ -51,8 +79,11 @@ pack build sample-app --path samples/apps/java-maven --builder cnbs/sample-build ### 3. Run it +Here we `--name` the running container so that we can clean up after it: + + ``` -docker run --rm -p 8080:8080 sample-app +docker run --rm -p 8080:8080 --name sample-app sample-app ``` @@ -62,18 +93,36 @@ docker run --rm -p 8080:8080 sample-app The app should now be running and accessible via [localhost:8080](http://localhost:8080). - +### 4. Verify it + +Executing + + +``` +curl http://localhost:8080 +``` + +should contain the `` +<!-- test:assert=contains --> +```text +Buildpacks.io Java Sample +``` + +### 5. Clean it up + +<!-- test:exec --> +``` +docker kill sample-app +``` ## What about ARM apps? Linux ARM image builds are now supported! <!--+- if false+--> -<a href="/docs/app-developer-guide/build-an-arm-app" class="button bg-blue">Linux ARM build guide</a> +<a href="/docs/app-developer-guide/how-to/build-an-arm-app" class="button bg-blue">Linux ARM build guide</a> <!--+end+--> <!--+ ` @@ -84,7 +133,7 @@ Check out the [Linux ARM build guide](https://buildpacks.io//docs/app-developer- Windows image builds are now supported! <!--+- if false+--> -<a href="/docs/app-developer-guide/build-a-windows-app" class="button bg-blue">Windows build guide</a> +<a href="/docs/app-developer-guide/how-to/build-a-windows-app" class="button bg-blue">Windows build guide</a> <!--+end+--> <!--+ ` Check out the [Windows build guide](https://buildpacks.io/docs/app-developer-guide/build-a-windows-app/). diff --git a/content/docs/concepts/_index.md b/content/docs/app-developer-guide/concepts/_index.md similarity index 99% rename from content/docs/concepts/_index.md rename to content/docs/app-developer-guide/concepts/_index.md index 6dd519c3d..c670466d2 100644 --- a/content/docs/concepts/_index.md +++ b/content/docs/app-developer-guide/concepts/_index.md @@ -1,6 +1,6 @@ +++ title="Concepts" -weight=3 +weight=1000 expand=false +++ diff --git a/content/docs/concepts/components/builder.md b/content/docs/app-developer-guide/concepts/builder.md similarity index 100% rename from content/docs/concepts/components/builder.md rename to content/docs/app-developer-guide/concepts/builder.md diff --git a/content/docs/concepts/builder.svg b/content/docs/app-developer-guide/concepts/builder.svg similarity index 100% rename from content/docs/concepts/builder.svg rename to content/docs/app-developer-guide/concepts/builder.svg diff --git a/content/docs/concepts/components/buildpack.md b/content/docs/app-developer-guide/concepts/buildpack.md similarity index 100% rename from content/docs/concepts/components/buildpack.md rename to content/docs/app-developer-guide/concepts/buildpack.md diff --git a/content/docs/concepts/components/_index.md b/content/docs/app-developer-guide/concepts/components/_index.md similarity index 100% rename from content/docs/concepts/components/_index.md rename to content/docs/app-developer-guide/concepts/components/_index.md diff --git a/content/docs/concepts/components/base-images/build.md b/content/docs/app-developer-guide/concepts/components/base-images/build.md similarity index 100% rename from content/docs/concepts/components/base-images/build.md rename to content/docs/app-developer-guide/concepts/components/base-images/build.md diff --git a/content/docs/concepts/components/base-images/run.md b/content/docs/app-developer-guide/concepts/components/base-images/run.md similarity index 100% rename from content/docs/concepts/components/base-images/run.md rename to content/docs/app-developer-guide/concepts/components/base-images/run.md diff --git a/content/docs/concepts/components/buildpack-group.md b/content/docs/app-developer-guide/concepts/components/buildpack-group.md similarity index 100% rename from content/docs/concepts/components/buildpack-group.md rename to content/docs/app-developer-guide/concepts/components/buildpack-group.md diff --git a/content/docs/concepts/components/create-builder.svg b/content/docs/app-developer-guide/concepts/components/create-builder.svg similarity index 100% rename from content/docs/concepts/components/create-builder.svg rename to content/docs/app-developer-guide/concepts/components/create-builder.svg diff --git a/content/docs/concepts/components/lifecycle/_index.md b/content/docs/app-developer-guide/concepts/components/lifecycle/_index.md similarity index 100% rename from content/docs/concepts/components/lifecycle/_index.md rename to content/docs/app-developer-guide/concepts/components/lifecycle/_index.md diff --git a/content/docs/concepts/components/lifecycle/analyze.md b/content/docs/app-developer-guide/concepts/components/lifecycle/analyze.md similarity index 100% rename from content/docs/concepts/components/lifecycle/analyze.md rename to content/docs/app-developer-guide/concepts/components/lifecycle/analyze.md diff --git a/content/docs/concepts/components/lifecycle/build.md b/content/docs/app-developer-guide/concepts/components/lifecycle/build.md similarity index 100% rename from content/docs/concepts/components/lifecycle/build.md rename to content/docs/app-developer-guide/concepts/components/lifecycle/build.md diff --git a/content/docs/concepts/components/lifecycle/create.md b/content/docs/app-developer-guide/concepts/components/lifecycle/create.md similarity index 100% rename from content/docs/concepts/components/lifecycle/create.md rename to content/docs/app-developer-guide/concepts/components/lifecycle/create.md diff --git a/content/docs/concepts/components/lifecycle/detect.md b/content/docs/app-developer-guide/concepts/components/lifecycle/detect.md similarity index 100% rename from content/docs/concepts/components/lifecycle/detect.md rename to content/docs/app-developer-guide/concepts/components/lifecycle/detect.md diff --git a/content/docs/concepts/components/lifecycle/export.md b/content/docs/app-developer-guide/concepts/components/lifecycle/export.md similarity index 100% rename from content/docs/concepts/components/lifecycle/export.md rename to content/docs/app-developer-guide/concepts/components/lifecycle/export.md diff --git a/content/docs/concepts/components/lifecycle/launch.md b/content/docs/app-developer-guide/concepts/components/lifecycle/launch.md similarity index 100% rename from content/docs/concepts/components/lifecycle/launch.md rename to content/docs/app-developer-guide/concepts/components/lifecycle/launch.md diff --git a/content/docs/concepts/components/lifecycle/rebase.md b/content/docs/app-developer-guide/concepts/components/lifecycle/rebase.md similarity index 100% rename from content/docs/concepts/components/lifecycle/rebase.md rename to content/docs/app-developer-guide/concepts/components/lifecycle/rebase.md diff --git a/content/docs/concepts/components/lifecycle/restore.md b/content/docs/app-developer-guide/concepts/components/lifecycle/restore.md similarity index 100% rename from content/docs/concepts/components/lifecycle/restore.md rename to content/docs/app-developer-guide/concepts/components/lifecycle/restore.md diff --git a/content/docs/concepts/components/stack.md b/content/docs/app-developer-guide/concepts/components/stack.md similarity index 100% rename from content/docs/concepts/components/stack.md rename to content/docs/app-developer-guide/concepts/components/stack.md diff --git a/content/docs/concepts/how.svg b/content/docs/app-developer-guide/concepts/how.svg similarity index 100% rename from content/docs/concepts/how.svg rename to content/docs/app-developer-guide/concepts/how.svg diff --git a/content/docs/concepts/operations/_index.md b/content/docs/app-developer-guide/concepts/operations/_index.md similarity index 100% rename from content/docs/concepts/operations/_index.md rename to content/docs/app-developer-guide/concepts/operations/_index.md diff --git a/content/docs/concepts/operations/build.md b/content/docs/app-developer-guide/concepts/operations/build.md similarity index 100% rename from content/docs/concepts/operations/build.md rename to content/docs/app-developer-guide/concepts/operations/build.md diff --git a/content/docs/concepts/operations/build.svg b/content/docs/app-developer-guide/concepts/operations/build.svg similarity index 100% rename from content/docs/concepts/operations/build.svg rename to content/docs/app-developer-guide/concepts/operations/build.svg diff --git a/content/docs/concepts/operations/rebase.md b/content/docs/app-developer-guide/concepts/operations/rebase.md similarity index 100% rename from content/docs/concepts/operations/rebase.md rename to content/docs/app-developer-guide/concepts/operations/rebase.md diff --git a/content/docs/concepts/operations/rebase.svg b/content/docs/app-developer-guide/concepts/operations/rebase.svg similarity index 100% rename from content/docs/concepts/operations/rebase.svg rename to content/docs/app-developer-guide/concepts/operations/rebase.svg diff --git a/content/docs/concepts/components/platform.md b/content/docs/app-developer-guide/concepts/platform.md similarity index 100% rename from content/docs/concepts/components/platform.md rename to content/docs/app-developer-guide/concepts/platform.md diff --git a/content/docs/concepts/components/targets.md b/content/docs/app-developer-guide/concepts/targets.md similarity index 100% rename from content/docs/concepts/components/targets.md rename to content/docs/app-developer-guide/concepts/targets.md diff --git a/content/docs/concepts/what.svg b/content/docs/app-developer-guide/concepts/what.svg similarity index 100% rename from content/docs/concepts/what.svg rename to content/docs/app-developer-guide/concepts/what.svg diff --git a/content/docs/app-developer-guide/how-to/_index.md b/content/docs/app-developer-guide/how-to/_index.md new file mode 100644 index 000000000..de5089696 --- /dev/null +++ b/content/docs/app-developer-guide/how-to/_index.md @@ -0,0 +1,5 @@ ++++ +title="How To" +weight=100 +summary="Short focused guides to performing a specific task" ++++ \ No newline at end of file diff --git a/content/docs/app-developer-guide/building-on-podman.md b/content/docs/app-developer-guide/how-to/building-on-podman.md similarity index 98% rename from content/docs/app-developer-guide/building-on-podman.md rename to content/docs/app-developer-guide/how-to/building-on-podman.md index 8baccff0f..45a3b4687 100644 --- a/content/docs/app-developer-guide/building-on-podman.md +++ b/content/docs/app-developer-guide/how-to/building-on-podman.md @@ -1,6 +1,6 @@ +++ -title="Building on Podman" -weight=99 +title="(Advanced) Building on Podman" +weight=20 summary="Use podman as an alternative to Docker with Cloud Native Buildpacks." aliases=[ "/docs/using-pack/building-app/" diff --git a/content/docs/app-developer-guide/run-an-app.md b/content/docs/app-developer-guide/how-to/run-an-app.md similarity index 100% rename from content/docs/app-developer-guide/run-an-app.md rename to content/docs/app-developer-guide/how-to/run-an-app.md diff --git a/content/docs/app-developer-guide/specify-buildpacks.md b/content/docs/app-developer-guide/how-to/specify-buildpacks.md similarity index 100% rename from content/docs/app-developer-guide/specify-buildpacks.md rename to content/docs/app-developer-guide/how-to/specify-buildpacks.md diff --git a/content/docs/app-developer-guide/using-cache-image.md b/content/docs/app-developer-guide/how-to/using-cache-image.md similarity index 100% rename from content/docs/app-developer-guide/using-cache-image.md rename to content/docs/app-developer-guide/how-to/using-cache-image.md diff --git a/content/docs/app-developer-guide/environment-variables.md b/content/docs/app-developer-guide/how-to/using-environment-variables.md similarity index 99% rename from content/docs/app-developer-guide/environment-variables.md rename to content/docs/app-developer-guide/how-to/using-environment-variables.md index c5895ef67..167a97bb5 100644 --- a/content/docs/app-developer-guide/environment-variables.md +++ b/content/docs/app-developer-guide/how-to/using-environment-variables.md @@ -1,6 +1,6 @@ +++ title="Environment variables" -weight=3 +weight=2 summary="Environment variables are a common way to configure various buildpacks at build-time." +++ <!--+- ` diff --git a/content/docs/app-developer-guide/using-http-proxy.md b/content/docs/app-developer-guide/how-to/using-http-proxy.md similarity index 100% rename from content/docs/app-developer-guide/using-http-proxy.md rename to content/docs/app-developer-guide/how-to/using-http-proxy.md diff --git a/content/docs/app-developer-guide/using-inline-buildpacks.md b/content/docs/app-developer-guide/how-to/using-inline-buildpacks.md similarity index 100% rename from content/docs/app-developer-guide/using-inline-buildpacks.md rename to content/docs/app-developer-guide/how-to/using-inline-buildpacks.md diff --git a/content/docs/app-developer-guide/using-project-descriptor.md b/content/docs/app-developer-guide/how-to/using-project-descriptor.md similarity index 100% rename from content/docs/app-developer-guide/using-project-descriptor.md rename to content/docs/app-developer-guide/how-to/using-project-descriptor.md diff --git a/content/docs/app-developer-guide/mounting-volumes.md b/content/docs/app-developer-guide/how-to/using-volumes.md similarity index 100% rename from content/docs/app-developer-guide/mounting-volumes.md rename to content/docs/app-developer-guide/how-to/using-volumes.md diff --git a/content/docs/app-developer-guide/tutorials/_index.md b/content/docs/app-developer-guide/tutorials/_index.md new file mode 100644 index 000000000..daf3e5a59 --- /dev/null +++ b/content/docs/app-developer-guide/tutorials/_index.md @@ -0,0 +1,5 @@ ++++ +title="Tutorials" +weight=200 +summary="Introductory articles that describe details" ++++ \ No newline at end of file diff --git a/content/docs/app-developer-guide/build-a-windows-app.md b/content/docs/app-developer-guide/tutorials/build-a-windows-app.md similarity index 99% rename from content/docs/app-developer-guide/build-a-windows-app.md rename to content/docs/app-developer-guide/tutorials/build-a-windows-app.md index 2dc65f640..64233f69a 100644 --- a/content/docs/app-developer-guide/build-a-windows-app.md +++ b/content/docs/app-developer-guide/tutorials/build-a-windows-app.md @@ -1,6 +1,6 @@ +++ -title="Build a Windows app" -weight=2 +title="(Advanced) Build a Windows app" +weight=20 summary="The basics of taking your Windows app from source code to runnable image." +++ diff --git a/content/docs/app-developer-guide/build-an-arm-app.md b/content/docs/app-developer-guide/tutorials/build-an-arm-app.md similarity index 98% rename from content/docs/app-developer-guide/build-an-arm-app.md rename to content/docs/app-developer-guide/tutorials/build-an-arm-app.md index cadfd5358..ff1a99c08 100644 --- a/content/docs/app-developer-guide/build-an-arm-app.md +++ b/content/docs/app-developer-guide/tutorials/build-an-arm-app.md @@ -1,6 +1,6 @@ +++ -title="Build an ARM app" -weight=2 +title="(Advanced) Build an ARM app" +weight=20 summary="The basics of taking your app from source code to runnable ARM image." +++ diff --git a/content/docs/buildpack-author-guide/_index.md b/content/docs/buildpack-author-guide/_index.md index 2ae3a823e..6a9a86b80 100644 --- a/content/docs/buildpack-author-guide/_index.md +++ b/content/docs/buildpack-author-guide/_index.md @@ -1,5 +1,5 @@ +++ -title="Buildpack Author Guide" +title="For Buildpack Authors" weight=4 include_summaries=true expand=true diff --git a/content/docs/operator-guide/_index.md b/content/docs/operator-guide/_index.md deleted file mode 100644 index 0db05c949..000000000 --- a/content/docs/operator-guide/_index.md +++ /dev/null @@ -1,6 +0,0 @@ -+++ -title="Operator Guide" -weight=5 -include_summaries=true -expand=true -+++ \ No newline at end of file diff --git a/content/docs/platform-guide/_index.md b/content/docs/platform-guide/_index.md index 1ae92ab41..642621f02 100644 --- a/content/docs/platform-guide/_index.md +++ b/content/docs/platform-guide/_index.md @@ -1,6 +1,6 @@ +++ -title="Platform Guide" -weight=6 +title="For Platform Operators" +weight=3 include_summaries=true expand=true +++ \ No newline at end of file diff --git a/content/docs/operator-guide/create-a-builder.md b/content/docs/platform-guide/create-a-builder.md similarity index 100% rename from content/docs/operator-guide/create-a-builder.md rename to content/docs/platform-guide/create-a-builder.md diff --git a/content/docs/operator-guide/create-a-stack.md b/content/docs/platform-guide/create-a-stack.md similarity index 100% rename from content/docs/operator-guide/create-a-stack.md rename to content/docs/platform-guide/create-a-stack.md diff --git a/content/docs/operator-guide/create-build-base.md b/content/docs/platform-guide/create-build-base.md similarity index 100% rename from content/docs/operator-guide/create-build-base.md rename to content/docs/platform-guide/create-build-base.md diff --git a/content/docs/operator-guide/create-run-base.md b/content/docs/platform-guide/create-run-base.md similarity index 100% rename from content/docs/operator-guide/create-run-base.md rename to content/docs/platform-guide/create-run-base.md