From 8036eac8dc7b23ef30af5597c2a8b4de2bd56409 Mon Sep 17 00:00:00 2001
From: Hayden <64056131+hay-kot@users.noreply.github.com>
Date: Sun, 14 Aug 2022 16:11:56 -0800
Subject: [PATCH] add tags and boost for pages

---
 docs/v1/examples/arguments.md               | 5 ++++-
 docs/v1/examples/bash-completions.md        | 5 +++++
 docs/v1/examples/combining-short-options.md | 5 +++++
 docs/v1/examples/exit-codes.md              | 5 +++++
 docs/v1/examples/flags.md                   | 5 +++++
 docs/v1/examples/generated-help-text.md     | 5 +++++
 docs/v1/examples/greet.md                   | 5 +++++
 docs/v1/examples/subcommands-categories.md  | 5 +++++
 docs/v1/examples/subcommands.md             | 5 +++++
 docs/v1/examples/version-flag.md            | 5 ++++-
 docs/v1/getting-started.md                  | 5 +++++
 docs/v1/migrating-to-v2.md                  | 5 ++++-
 docs/v2/examples/arguments.md               | 7 +++++++
 docs/v2/examples/bash-completions.md        | 7 +++++++
 docs/v2/examples/combining-short-options.md | 7 +++++++
 docs/v2/examples/exit-codes.md              | 7 +++++++
 docs/v2/examples/flags.md                   | 7 +++++++
 docs/v2/examples/full-api-example.md        | 7 +++++++
 docs/v2/examples/generated-help-text.md     | 7 +++++++
 docs/v2/examples/greet.md                   | 7 +++++++
 docs/v2/examples/subcommands-categories.md  | 7 +++++++
 docs/v2/examples/subcommands.md             | 7 +++++++
 docs/v2/examples/suggestions.md             | 7 +++++++
 docs/v2/examples/timestamp-flag.md          | 7 +++++++
 docs/v2/examples/version-flag.md            | 7 +++++++
 docs/v2/getting-started.md                  | 7 +++++++
 docs/v2/migrating-from-older-releases.md    | 7 +++++++
 27 files changed, 162 insertions(+), 3 deletions(-)

diff --git a/docs/v1/examples/arguments.md b/docs/v1/examples/arguments.md
index ba451b6..4416d32 100644
--- a/docs/v1/examples/arguments.md
+++ b/docs/v1/examples/arguments.md
@@ -1,4 +1,7 @@
-### Arguments
+---
+tags:
+  - v1
+---
 
 You can lookup arguments by calling the `Args` function on `cli.Context`, e.g.:
 
diff --git a/docs/v1/examples/bash-completions.md b/docs/v1/examples/bash-completions.md
index 5648477..73af176 100644
--- a/docs/v1/examples/bash-completions.md
+++ b/docs/v1/examples/bash-completions.md
@@ -1,3 +1,8 @@
+---
+tags:
+  - v1
+---
+
 You can enable completion commands by setting the `EnableBashCompletion`
 flag on the `App` object.  By default, this setting will only auto-complete to
 show an app's subcommands, but you can write your own completion methods for
diff --git a/docs/v1/examples/combining-short-options.md b/docs/v1/examples/combining-short-options.md
index 3ab6ebd..0496300 100644
--- a/docs/v1/examples/combining-short-options.md
+++ b/docs/v1/examples/combining-short-options.md
@@ -1,3 +1,8 @@
+---
+tags:
+  - v1
+---
+
 Traditional use of options using their shortnames look like this:
 
 ```
diff --git a/docs/v1/examples/exit-codes.md b/docs/v1/examples/exit-codes.md
index 39c0642..1d6627d 100644
--- a/docs/v1/examples/exit-codes.md
+++ b/docs/v1/examples/exit-codes.md
@@ -1,3 +1,8 @@
+---
+tags:
+  - v1
+---
+
 Calling `App.Run` will not automatically call `os.Exit`, which means that by
 default the exit code will "fall through" to being `0`.  An explicit exit code
 may be set by returning a non-nil error that fulfills `cli.ExitCoder`, *or* a
diff --git a/docs/v1/examples/flags.md b/docs/v1/examples/flags.md
index f6ae7be..2f9300b 100644
--- a/docs/v1/examples/flags.md
+++ b/docs/v1/examples/flags.md
@@ -1,3 +1,8 @@
+---
+tags:
+  - v1
+---
+
 Setting and querying flags is simple.
 
 <!-- {
diff --git a/docs/v1/examples/generated-help-text.md b/docs/v1/examples/generated-help-text.md
index 0c7f110..84ec272 100644
--- a/docs/v1/examples/generated-help-text.md
+++ b/docs/v1/examples/generated-help-text.md
@@ -1,3 +1,8 @@
+---
+tags:
+  - v1
+---
+
 The default help flag (`-h/--help`) is defined as `cli.HelpFlag` and is checked
 by the cli internals in order to print generated help text for the app, command,
 or subcommand, and break execution.
diff --git a/docs/v1/examples/greet.md b/docs/v1/examples/greet.md
index 7b47cf6..7314893 100644
--- a/docs/v1/examples/greet.md
+++ b/docs/v1/examples/greet.md
@@ -1,3 +1,8 @@
+---
+tags:
+  - v1
+---
+
 Being a programmer can be a lonely job. Thankfully by the power of automation
 that is not the case! Let's create a greeter app to fend off our demons of
 loneliness!
diff --git a/docs/v1/examples/subcommands-categories.md b/docs/v1/examples/subcommands-categories.md
index b10c1f9..27c2bd1 100644
--- a/docs/v1/examples/subcommands-categories.md
+++ b/docs/v1/examples/subcommands-categories.md
@@ -1,3 +1,8 @@
+---
+tags:
+  - v1
+---
+
 For additional organization in apps that have many subcommands, you can
 associate a category for each command to group them together in the help
 output.
diff --git a/docs/v1/examples/subcommands.md b/docs/v1/examples/subcommands.md
index f062ba7..e1be306 100644
--- a/docs/v1/examples/subcommands.md
+++ b/docs/v1/examples/subcommands.md
@@ -1,3 +1,8 @@
+---
+tags:
+  - v1
+---
+
 Subcommands can be defined for a more git-like command line app.
 
 <!-- {
diff --git a/docs/v1/examples/version-flag.md b/docs/v1/examples/version-flag.md
index 482eea4..dc089a1 100644
--- a/docs/v1/examples/version-flag.md
+++ b/docs/v1/examples/version-flag.md
@@ -1,4 +1,7 @@
-### Version Flag
+---
+tags:
+  - v1
+---
 
 The default version flag (`-v/--version`) is defined as `cli.VersionFlag`, which
 is checked by the cli internals in order to print the `App.Version` via
diff --git a/docs/v1/getting-started.md b/docs/v1/getting-started.md
index b144483..b98f011 100644
--- a/docs/v1/getting-started.md
+++ b/docs/v1/getting-started.md
@@ -1,3 +1,8 @@
+---
+tags:
+  - v1
+---
+
 One of the philosophies behind cli is that an API should be playful and full of
 discovery. So a cli app can be as little as one line of code in `main()`.
 
diff --git a/docs/v1/migrating-to-v2.md b/docs/v1/migrating-to-v2.md
index ec186ef..059b7db 100644
--- a/docs/v1/migrating-to-v2.md
+++ b/docs/v1/migrating-to-v2.md
@@ -1,4 +1,7 @@
-## Migrating to V2
+---
+tags:
+  - v1
+---
 
 There are a small set of breaking changes between v1 and v2.
 Converting is relatively straightforward and typically takes less than
diff --git a/docs/v2/examples/arguments.md b/docs/v2/examples/arguments.md
index ccfd4c0..88dd460 100644
--- a/docs/v2/examples/arguments.md
+++ b/docs/v2/examples/arguments.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 You can lookup arguments by calling the `Args` function on `cli.Context`, e.g.:
 
 <!-- {
diff --git a/docs/v2/examples/bash-completions.md b/docs/v2/examples/bash-completions.md
index 0dde02f..e9265f4 100644
--- a/docs/v2/examples/bash-completions.md
+++ b/docs/v2/examples/bash-completions.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 You can enable completion commands by setting the `EnableBashCompletion` flag on
 the `App` object to `true`.  By default, this setting will allow auto-completion
 for an app's subcommands, but you can write your own completion methods for the
diff --git a/docs/v2/examples/combining-short-options.md b/docs/v2/examples/combining-short-options.md
index b0a590a..f502877 100644
--- a/docs/v2/examples/combining-short-options.md
+++ b/docs/v2/examples/combining-short-options.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 Traditional use of options using their shortnames look like this:
 
 ```sh-session
diff --git a/docs/v2/examples/exit-codes.md b/docs/v2/examples/exit-codes.md
index 90e1384..75db781 100644
--- a/docs/v2/examples/exit-codes.md
+++ b/docs/v2/examples/exit-codes.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 Calling `App.Run` will not automatically call `os.Exit`, which means that by
 default the exit code will "fall through" to being `0`.  An explicit exit code
 may be set by returning a non-nil error that fulfills `cli.ExitCoder`, *or* a
diff --git a/docs/v2/examples/flags.md b/docs/v2/examples/flags.md
index a3c5e76..2a629f7 100644
--- a/docs/v2/examples/flags.md
+++ b/docs/v2/examples/flags.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 Setting and querying flags is simple.
 
 <!-- {
diff --git a/docs/v2/examples/full-api-example.md b/docs/v2/examples/full-api-example.md
index 53c76ea..289cffe 100644
--- a/docs/v2/examples/full-api-example.md
+++ b/docs/v2/examples/full-api-example.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 **Notice**: This is a contrived (functioning) example meant strictly for API
 demonstration purposes. Use of one's imagination is encouraged.
 
diff --git a/docs/v2/examples/generated-help-text.md b/docs/v2/examples/generated-help-text.md
index caa3a38..f733b96 100644
--- a/docs/v2/examples/generated-help-text.md
+++ b/docs/v2/examples/generated-help-text.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 The default help flag (`-h/--help`) is defined as `cli.HelpFlag` and is checked
 by the cli internals in order to print generated help text for the app, command,
 or subcommand, and break execution.
diff --git a/docs/v2/examples/greet.md b/docs/v2/examples/greet.md
index cedee7d..aee4b0c 100644
--- a/docs/v2/examples/greet.md
+++ b/docs/v2/examples/greet.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 Being a programmer can be a lonely job. Thankfully by the power of automation
 that is not the case! Let's create a greeter app to fend off our demons of
 loneliness!
diff --git a/docs/v2/examples/subcommands-categories.md b/docs/v2/examples/subcommands-categories.md
index e8ae185..5f0b8d2 100644
--- a/docs/v2/examples/subcommands-categories.md
+++ b/docs/v2/examples/subcommands-categories.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 For additional organization in apps that have many subcommands, you can
 associate a category for each command to group them together in the help
 output, e.g.:
diff --git a/docs/v2/examples/subcommands.md b/docs/v2/examples/subcommands.md
index b7048b9..b054622 100644
--- a/docs/v2/examples/subcommands.md
+++ b/docs/v2/examples/subcommands.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 Subcommands can be defined for a more git-like command line app.
 
 <!-- {
diff --git a/docs/v2/examples/suggestions.md b/docs/v2/examples/suggestions.md
index 3e60828..9a0cd3f 100644
--- a/docs/v2/examples/suggestions.md
+++ b/docs/v2/examples/suggestions.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 To enable flag and command suggestions, set `app.Suggest = true`. If the suggest
 feature is enabled, then the help output of the corresponding command will
 provide an appropriate suggestion for the provided flag or subcommand if
diff --git a/docs/v2/examples/timestamp-flag.md b/docs/v2/examples/timestamp-flag.md
index bcf0262..4e19adf 100644
--- a/docs/v2/examples/timestamp-flag.md
+++ b/docs/v2/examples/timestamp-flag.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 Using the timestamp flag is simple. Please refer to
 [`time.Parse`](https://golang.org/pkg/time/#example_Parse) to get possible
 formats.
diff --git a/docs/v2/examples/version-flag.md b/docs/v2/examples/version-flag.md
index a014c29..af0508c 100644
--- a/docs/v2/examples/version-flag.md
+++ b/docs/v2/examples/version-flag.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 The default version flag (`-v/--version`) is defined as `cli.VersionFlag`, which
 is checked by the cli internals in order to print the `App.Version` via
 `cli.VersionPrinter` and break execution.
diff --git a/docs/v2/getting-started.md b/docs/v2/getting-started.md
index c2e0750..1d631cf 100644
--- a/docs/v2/getting-started.md
+++ b/docs/v2/getting-started.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 One of the philosophies behind cli is that an API should be playful and full of
 discovery. So a cli app can be as little as one line of code in `main()`.
 
diff --git a/docs/v2/migrating-from-older-releases.md b/docs/v2/migrating-from-older-releases.md
index 564cd20..7bb33af 100644
--- a/docs/v2/migrating-from-older-releases.md
+++ b/docs/v2/migrating-from-older-releases.md
@@ -1,3 +1,10 @@
+---
+tags:
+  - v2
+search:
+  boost: 2
+---
+
 There are a small set of breaking changes between v1 and v2.  Converting is
 relatively straightforward and typically takes less than an hour. Specific steps
 are included in [Migration Guide: v1 to v2](../migrate-v1-to-v2.md). Also see