Clean up buildpack-author tutorials

Natalie Arellano · Natalie Arellano · commit e272ddaa0a9b · 2024-02-14T16:47:02.000-05:00
Signed-off-by: Natalie Arellano &lt;narellano@vmware.com&gt;
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-buildpack/01_setup-local-environment.md b/content/docs/for-buildpack-authors/tutorials/basic-buildpack/01_setup-local-environment.md
@@ -1,8 +1,15 @@
 +++
-title="Set up your local environment"
+title="Setting up your local environment"
 weight=1
 +++
 
+### Check system requirements
+
+Before we get started, make sure you've got the following installed:
+
+{{< 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 {{</>}}
+
 <!-- test:suite=create-buildpack;weight=1 -->
 
 <!-- test:setup:exec;exit-code=-1 -->
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-buildpack/02_building-blocks-cnb.md b/content/docs/for-buildpack-authors/tutorials/basic-buildpack/02_building-blocks-cnb.md
@@ -1,5 +1,5 @@
 +++
-title="Building blocks of a Cloud Native Buildpack"
+title="The building blocks of a Cloud Native Buildpack"
 weight=2
 +++
 
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-buildpack/03_detection.md b/content/docs/for-buildpack-authors/tutorials/basic-buildpack/03_detection.md
@@ -1,6 +1,6 @@
 +++
 title="Detecting your application"
-weight=403
+weight=3
 +++
 
 <!-- test:suite=create-buildpack;weight=3 -->
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-buildpack/04_build-app.md b/content/docs/for-buildpack-authors/tutorials/basic-buildpack/04_build-app.md
@@ -1,6 +1,6 @@
 +++
 title="Building your application"
-weight=404
+weight=4
 +++
 
 <!-- test:suite=create-buildpack;weight=4 -->
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-buildpack/05_make-app-runnable.md b/content/docs/for-buildpack-authors/tutorials/basic-buildpack/05_make-app-runnable.md
@@ -1,6 +1,6 @@
 +++
-title="Make your application runnable"
-weight=405
+title="Making your application runnable"
+weight=5
 +++
 
 <!-- test:suite=create-buildpack;weight=5 -->
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-buildpack/06_caching.md b/content/docs/for-buildpack-authors/tutorials/basic-buildpack/06_caching.md
@@ -1,6 +1,6 @@
 +++
 title="Improving performance with caching"
-weight=407
+weight=6
 +++
 
 <!-- test:suite=create-buildpack;weight=7 -->
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-buildpack/07_make-buildpack-configurable.md b/content/docs/for-buildpack-authors/tutorials/basic-buildpack/07_make-buildpack-configurable.md
@@ -1,6 +1,6 @@
 +++
 title="Making your buildpack configurable"
-weight=408
+weight=7
 +++
 
 <!-- test:suite=create-buildpack;weight=8 -->
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-buildpack/_index.md b/content/docs/for-buildpack-authors/tutorials/basic-buildpack/_index.md
@@ -1,33 +1,24 @@
 +++
 title="Write a basic buildpack"
 weight=1
-expand=true
-include_summaries=true
 +++
 
-## Prerequisites
-
-Before we get started, make sure you've got the following installed:
-
-{{< 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 {{</>}}
-
+This is a step-by-step tutorial for creating a nodeJS Cloud Native Buildpack.
 
-## Overview
-<!--+end+-->
+<!--more-->
 
-This is a step-by-step tutorial for creating a nodeJS Cloud Native Buildpack.
+## What we'll cover
 
-- [Set up your local environment](/docs/for-buildpack-authors/tutorials/basic-buildpack/01_setup-local-environment)
-- [Building blocks of a Cloud Native Buildpack](/docs/for-buildpack-authors/tutorials/basic-buildpack/02_building-blocks-cnb)
+- [Setting up your local environment](/docs/for-buildpack-authors/tutorials/basic-buildpack/01_setup-local-environment)
+- [The building blocks of a Cloud Native Buildpack](/docs/for-buildpack-authors/tutorials/basic-buildpack/02_building-blocks-cnb)
 - [Detecting your application](/docs/for-buildpack-authors/tutorials/basic-buildpack/03_detection)
 - [Building your application](/docs/for-buildpack-authors/tutorials/basic-buildpack/04_build-app)
 - [Making your application runnable](/docs/for-buildpack-authors/tutorials/basic-buildpack/05_make-app-runnable)
 - [Improving performance with caching](/docs/for-buildpack-authors/tutorials/basic-buildpack/06_caching)
 - [Making your buildpack configurable](/docs/for-buildpack-authors/tutorials/basic-buildpack/07_make-buildpack-configurable)
 
-<!--+if false+-->
----
+<br>
 
-<a href="/docs/for-buildpack-authors/tutorials/basic-buildpack/01_setup-local-environment" class="button bg-pink">Start Tutorial</a>
-<!--+end+-->
+<a href="/docs/for-buildpack-authors/tutorials/basic-buildpack/01_setup-local-environment" class="button bg-pink">
+  Start Tutorial
+</a>
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-extension/01_setup-local-environment.md b/content/docs/for-buildpack-authors/tutorials/basic-extension/01_setup-local-environment.md
@@ -1,11 +1,13 @@
 +++
-title="Set up your local environment"
+title="Setting up your local environment"
 weight=1
 aliases = [
   "/docs/extension-author-guide/create-extension/setup-local-environment/",
   ]
 +++
 
+<!--more-->
+
 Let's walk through a build that uses extensions, step by step. We will see an image extension that installs `curl` on
 the builder image, and switches the run image to an image that has `curl` installed.
 
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-extension/02_why-dockerfiles.md b/content/docs/for-buildpack-authors/tutorials/basic-extension/02_why-dockerfiles.md
@@ -6,6 +6,8 @@ aliases = [
   ]
 +++
 
+<!--more-->
+
 <!-- test:suite=dockerfiles;weight=2 -->
 
 Let's see a build that requires base image extension in order to succeed.
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-extension/03_building-blocks-extension.md b/content/docs/for-buildpack-authors/tutorials/basic-extension/03_building-blocks-extension.md
@@ -6,6 +6,8 @@ aliases = [
   ]
 +++
 
+<!--more-->
+
 <!-- test:suite=dockerfiles;weight=3 -->
 
 ### Examine `vim` extension
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-extension/04_build-dockerfile.md b/content/docs/for-buildpack-authors/tutorials/basic-extension/04_build-dockerfile.md
@@ -6,6 +6,8 @@ aliases = [
   ]
 +++
 
+<!--more-->
+
 <!-- test:suite=dockerfiles;weight=4 -->
 
 Builder images can be kept lean if image extensions are used to dynamically install the needed dependencies
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-extension/05_run-dockerfile-switch.md b/content/docs/for-buildpack-authors/tutorials/basic-extension/05_run-dockerfile-switch.md
@@ -6,6 +6,8 @@ aliases = [
   ]
 +++
 
+<!--more-->
+
 <!-- test:suite=dockerfiles;weight=5 -->
 
 Platforms can have several run images available, each tailored to a specific language family - thus limiting the number
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-extension/06_run-dockerfile-extend.md b/content/docs/for-buildpack-authors/tutorials/basic-extension/06_run-dockerfile-extend.md
@@ -3,6 +3,8 @@ title="Extending the runtime base image with a run.Dockerfile"
 weight=6
 +++
 
+<!--more-->
+
 <!-- test:suite=dockerfiles;weight=6 -->
 
 Run images can be kept lean if image extensions are used to dynamically install the needed dependencies
diff --git a/content/docs/for-buildpack-authors/tutorials/basic-extension/_index.md b/content/docs/for-buildpack-authors/tutorials/basic-extension/_index.md
@@ -4,11 +4,23 @@ weight=2
 aliases = [
   "/docs/extension-author-guide/create-extension"
   ]
-include_summaries=false
 +++
 
 This is a step-by-step tutorial for creating and using image extensions, which allow for customization of the build-time and runtime base images using Dockerfiles.
 
 <!--more-->
 
-<a href="/docs/for-buildpack-authors/tutorials/basic-extension/01_setup-local-environment" class="button bg-pink">Start Tutorial</a>
+## What we'll cover
+
+- [Setting up your local environment](/docs/for-buildpack-authors/tutorials/basic-extension/01_setup-local-environment)
+- [Why this feature?](/docs/for-buildpack-authors/tutorials/basic-extension/02_why-dockerfiles)
+- [The building blocks of a Cloud Native Buildpacks image extension](/docs/for-buildpack-authors/tutorials/basic-extension/03_building-blocks-extension)
+- [Extending the build-time base image with a build.Dockerfile](/docs/for-buildpack-authors/tutorials/basic-extension/04_build-dockerfile)
+- [Switching the runtime base image with a run.Dockerfile](/docs/for-buildpack-authors/tutorials/basic-extension/05_run-dockerfile-switch)
+- [Extending the runtime base image with a run.Dockerfile](/docs/for-buildpack-authors/tutorials/basic-extension/06_run-dockerfile-extend)
+
+<br>
+
+<a href="/docs/for-buildpack-authors/tutorials/basic-extension/01_setup-local-environment" class="button bg-pink">
+  Start Tutorial
+</a>

Original file line number	Diff line number	Diff line change
`@@ -6,6 +6,8 @@ aliases = [`
`6`	`6`	`]`
`7`	`7`	`+++`
`8`	`8`
	`9`	`+<!--more-->`
	`10`	`+`
`9`	`11`	`<!-- test:suite=dockerfiles;weight=2 -->`
`10`	`12`
`11`	`13`	`Let's see a build that requires base image extension in order to succeed.`