refactor: flatten the usage docs (#191)

content/usage/getting-started/authenticate.md → content/usage/authenticate.md

@@ -1,7 +1,6 @@
 ---
 title: "Authenticate"
 linkTitle: "Authenticate"
-weight: 1
 description: >
   Authenticate to your Vela instance.
 ---

content/usage/badge/_index.md → content/usage/badge.md

@@ -1,7 +1,6 @@
 ---
 title: "Badges"
 linkTitle: "Badges"
-weight: 4
 description: >
   Show off your build status.
 ---

content/usage/getting-started/docker.md → content/usage/docker.md

@@ -1,7 +1,6 @@
 ---
 title: "Building Docker Images"
 toc: true
-weight: 7
 description: >
   Understanding the options for how to build a Dockerfile
 ---

content/usage/getting-started/enable_repo.md → content/usage/enable_repo.md

@@ -1,7 +1,6 @@
 ---
 title: "Enable a Repo"
 linkTitle: "Enable a Repo"
-weight: 3
 description: >
   Learn how to add your first repo.
 ---

content/usage/getting-started/environment.md → content/usage/environment.md

@@ -1,7 +1,6 @@
 ---
 title: "Using the Environment"
 toc: true
-weight: 6
 description: >
   Learn about how to leverage the environment within your builds.
 ---

content/usage/examples/_index.md

@@ -0,0 +1,7 @@
+---
+title: "Examples"
+toc: true
+weight: 2
+description: >
+  View example pipelines for a quick start.
+---

content/usage/samples/go_modules.md → content/usage/examples/go_modules.md

@@ -3,10 +3,10 @@ title: "Go (With Modules)"
 toc: true
 weight: 1
 description: >
-  Sample Go (With Modules) Pipeline
+  Example Go (With Modules) Pipeline
 ---
 
-Sample [Yaml](https://yaml.org/spec/) configuration for a project building a [Go](https://golang.org/) binary with [Go modules](https://github.com/golang/go/wiki/Modules).
+Example [Yaml](https://yaml.org/spec/) configuration for a project building a [Go](https://golang.org/) binary with [Go modules](https://github.com/golang/go/wiki/Modules).
 
 ## Scenario
 

content/usage/samples/java_gradle.md → content/usage/examples/java_gradle.md

@@ -3,10 +3,10 @@ title: "Java (With Gradle)"
 toc: true
 weight: 2
 description: >
-  Sample Java (With Gradle) Pipeline
+  Example Java (With Gradle) Pipeline
 ---
 
-Sample [Yaml](https://yaml.org/spec/) configuration for a project building a [Java](https://docs.oracle.com/en/java/) application with [Gradle](https://docs.gradle.org/current/userguide/userguide.html).
+Example [Yaml](https://yaml.org/spec/) configuration for a project building a [Java](https://docs.oracle.com/en/java/) application with [Gradle](https://docs.gradle.org/current/userguide/userguide.html).
 
 ## Scenario
 

content/usage/samples/java_maven.md → content/usage/examples/java_maven.md

@@ -3,10 +3,10 @@ title: "Java (With Maven)"
 toc: true
 weight: 2
 description: >
-  Sample Java (With Maven) Pipeline
+  Example Java (With Maven) Pipeline
 ---
 
-Sample [Yaml](https://yaml.org/spec/) configuration for a project building a [Java](https://docs.oracle.com/en/java/) application with [Maven](https://maven.apache.org/guides/index.html).
+Example [Yaml](https://yaml.org/spec/) configuration for a project building a [Java](https://docs.oracle.com/en/java/) application with [Maven](https://maven.apache.org/guides/index.html).
 
 ## Scenario
 

content/usage/samples/mongo.md → content/usage/examples/mongo.md

@@ -3,10 +3,10 @@ title: "Mongo"
 toc: true
 weight: 1
 description: >
-  Sample Pipeline with Mongo
+  Example Pipeline with Mongo
 ---
 
-Sample [Yaml](https://yaml.org/spec/) configuration for a project requiring a [Mongo](https://www.mongodb.com/) as a pipeline dependency.
+Example [Yaml](https://yaml.org/spec/) configuration for a project requiring a [Mongo](https://www.mongodb.com/) as a pipeline dependency.
 
 ## Scenario
 

content/usage/samples/node.md → content/usage/examples/node.md

@@ -3,10 +3,10 @@ title: "Node"
 toc: true
 weight: 3
 description: >
-  Sample Node Pipeline
+  Example Node Pipeline
 ---
 
-Sample [Yaml](https://yaml.org/spec/) configuration for a project building a [Node](https://nodejs.org/en/docs/) application.
+Example [Yaml](https://yaml.org/spec/) configuration for a project building a [Node](https://nodejs.org/en/docs/) application.
 
 ## Scenario
 

content/usage/samples/postgres.md → content/usage/examples/postgres.md

@@ -3,10 +3,10 @@ title: "Postgres"
 toc: true
 weight: 1
 description: >
-  Sample Pipeline with Postgres
+  Example Pipeline with Postgres
 ---
 
-Sample [Yaml](https://yaml.org/spec/) configuration for a project requiring a [Postgres](https://www.postgresql.org/) as a pipeline dependency.
+Example [Yaml](https://yaml.org/spec/) configuration for a project requiring a [Postgres](https://www.postgresql.org/) as a pipeline dependency.
 
 ## Scenario
 

content/usage/samples/redis.md → content/usage/examples/redis.md

@@ -3,10 +3,10 @@ title: "Redis"
 toc: true
 weight: 1
 description: >
-  Sample Pipeline with Redis
+  Example Pipeline with Redis
 ---
 
-Sample [Yaml](https://yaml.org/spec/) configuration for a project requiring a [Redis](https://redis.io/) as a pipeline dependency.
+Example [Yaml](https://yaml.org/spec/) configuration for a project requiring a [Redis](https://redis.io/) as a pipeline dependency.
 
 ## Scenario
 

content/usage/samples/route.md → content/usage/examples/route.md

@@ -3,10 +3,10 @@ title: "Route"
 toc: true
 weight: 1
 description: >
-  Sample Pipeline with build routing
+  Example Pipeline with build routing
 ---
 
-Sample [Yaml](https://yaml.org/spec/) configuration for a project requiring a specific runtime or platform.
+Example [Yaml](https://yaml.org/spec/) configuration for a project requiring a specific runtime or platform.
 
 ## Scenario
 

content/usage/samples/rust_cargo.md → content/usage/examples/rust_cargo.md

@@ -3,10 +3,10 @@ title: "Rust (With Cargo)"
 toc: true
 weight: 1
 description: >
-  Sample Rust (With Cargo) Pipeline
+  Example Rust (With Cargo) Pipeline
 ---
 
-Sample [Yaml](https://yaml.org/spec/) configuration for a project building a [Rust](https://www.rust-lang.org/) binary with [Cargo](https://doc.rust-lang.org/cargo/commands/cargo-doc.html).
+Example [Yaml](https://yaml.org/spec/) configuration for a project building a [Rust](https://www.rust-lang.org/) binary with [Cargo](https://doc.rust-lang.org/cargo/commands/cargo-doc.html).
 
 ## Scenario
 

content/usage/samples/secrets_external.md → content/usage/examples/secrets_external.md

@@ -3,10 +3,10 @@ title: "External Secrets"
 toc: true
 weight: 1
 description: >
-  Sample pipeline with external secrets
+  Example pipeline with external secrets
 ---
 
-Sample [Yaml](https://yaml.org/spec/) configuration for a project requiring a secrets to be used within a step
+Example [Yaml](https://yaml.org/spec/) configuration for a project requiring a secrets to be used within a step
 
 ## Scenario
 
@@ -16,7 +16,7 @@ User is looking to create a pipeline that can integrate with a private Vault to
 It is assumed you have created secret `vault_token` in the web interface or [CLI](/docs/cli/).
 {{% /alert %}}
 
-The samples show a pipeline using repository secrets. Vela contains three secret types: repository, organization, and shared. For examples on organization and shared, please see the [secret concepts](/docs/concepts/pipeline/steps/secrets/) documentation.
+The examples show a pipeline using repository secrets. Vela contains three secret types: repository, organization, and shared. For examples on organization and shared, please see the [secret concepts](/docs/concepts/pipeline/steps/secrets/) documentation.
 
 ### Steps
 

content/usage/samples/secrets_internal.md → content/usage/examples/secrets_internal.md

@@ -3,10 +3,10 @@ title: "Internal Secrets"
 toc: true
 weight: 1
 description: >
-  Sample Pipeline with internal secrets
+  Example Pipeline with internal secrets
 ---
 
-Sample [Yaml](https://yaml.org/spec/) configuration for a project requiring a secrets to be used within a step
+Example [Yaml](https://yaml.org/spec/) configuration for a project requiring a secrets to be used within a step
 
 ## Scenario
 
@@ -16,7 +16,7 @@ User is looking to create a pipeline that can inject configuration that can not
 It is assumed you have created secrets `docker_username` and `docker_password` in the web interface or [CLI](/docs/cli/).
 {{% /alert %}}
 
-The samples show a pipeline using repository secrets. Vela contains three secret types: repository, organization, and shared. For examples on organization and shared, please see the [secret concepts](/docs/concepts/pipeline/steps/secrets/) documentation.
+The examples show a pipeline using repository secrets. Vela contains three secret types: repository, organization, and shared. For examples on organization and shared, please see the [secret concepts](/docs/concepts/pipeline/steps/secrets/) documentation.
 
 ### Steps
 

content/usage/getting-started/pull_policies.md → content/usage/pull_policies.md

@@ -1,7 +1,6 @@
 ---
 title: "Pull Policies"
 toc: true
-weight: 8
 description: >
   Learn how to control pulling images in your pipeline.
 ---

content/usage/getting-started/roles.md → content/usage/roles.md

@@ -1,7 +1,6 @@
 ---
 title: "Roles"
 linkTitle: "Roles"
-weight: 2
 description: >
   Learn about the authorization roles.
 ---

content/usage/validation/schema.md → content/usage/schema.md

@@ -1,7 +1,6 @@
 ---
-title: "JSON Schema"
+title: "JSON Schema support"
 toc: true
-weight: 1
 description: >
   JSON Schema information.
 ---

content/usage/getting-started/skipping_build.md → content/usage/skipping_build.md

@@ -1,7 +1,6 @@
 ---
 title: "Skipping a Build"
 linkTitle: "Skipping a Build"
-weight: 5
 description: >
   Skip builds for certain commits.
 ---

content/usage/getting-started/start_build.md → content/usage/start_build.md

@@ -1,7 +1,6 @@
 ---
 title: "Start a Build"
 linkTitle: "Start a Build"
-weight: 4
 description: >
   Start a build for the first time.
 ---

content/usage/getting-started/workspace.md → content/usage/workspace.md

@@ -1,7 +1,6 @@
 ---
 title: "Understanding the Workspace"
 toc: true
-weight: 7
 description: >
   Shared directory that all build steps begin at.
 ---