Add alpha command group

commands/alphacmd.go

@@ -0,0 +1,45 @@
+// Copyright 2022 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package commands
+
+import (
+	"context"
+
+	"github.com/GoogleContainerTools/kpt/internal/docs/generated/alphadocs"
+	"github.com/spf13/cobra"
+)
+
+func GetAlphaCommand(ctx context.Context, name string) *cobra.Command {
+	alpha := &cobra.Command{
+		Use:   "alpha",
+		Short: alphadocs.AlphaShort,
+		Long:  alphadocs.AlphaLong,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			h, err := cmd.Flags().GetBool("help")
+			if err != nil {
+				return err
+			}
+			if h {
+				return cmd.Help()
+			}
+			return cmd.Usage()
+		},
+		Hidden: true,
+	}
+
+	// TODO: add individual commands
+
+	return alpha
+}

commands/commands.go

@@ -35,8 +35,9 @@ func GetKptCommands(ctx context.Context, name, version string) []*cobra.Command
 	fnCmd := GetFnCommand(ctx, name)
 	pkgCmd := GetPkgCommand(ctx, name)
 	liveCmd := GetLiveCommand(ctx, name, version)
+	alphaCmd := GetAlphaCommand(ctx, name)
 
-	c = append(c, pkgCmd, fnCmd, liveCmd)
+	c = append(c, pkgCmd, fnCmd, liveCmd, alphaCmd)
 
 	// apply cross-cutting issues to commands
 	NormalizeCommand(c...)

main.go

@@ -15,6 +15,7 @@
 //go:generate $GOBIN/mdtogo site/reference/cli/live internal/docs/generated/livedocs --license=none --recursive=true --strategy=cmdDocs
 //go:generate $GOBIN/mdtogo site/reference/cli/pkg internal/docs/generated/pkgdocs --license=none --recursive=true --strategy=cmdDocs
 //go:generate $GOBIN/mdtogo site/reference/cli/fn internal/docs/generated/fndocs --license=none --recursive=true --strategy=cmdDocs
+//go:generate $GOBIN/mdtogo site/reference/cli/alpha internal/docs/generated/alphadocs --license=none --recursive=true --strategy=cmdDocs
 //go:generate $GOBIN/mdtogo site/reference/cli/README.md internal/docs/generated/overview --license=none --strategy=cmdDocs
 package main
 

site/reference/cli/README.md

@@ -14,14 +14,16 @@ kpt <group> <command> <positional args> [PKG_PATH] [flags]
 
 kpt functionality is divided into three command groups:
 
-| Group  | Description                                                           |
-| ------ | --------------------------------------------------------------------- |
-| [pkg]  | get, update, and describe packages with resources.                    |
-| [fn]   | generate, transform, validate packages using containerized functions. |
-| [live] | deploy local configuration packages to a cluster.                     |
+| Group   | Description                                                           |
+| ------- | --------------------------------------------------------------------- |
+| [pkg]   | get, update, and describe packages with resources.                    |
+| [fn]    | generate, transform, validate packages using containerized functions. |
+| [live]  | deploy local configuration packages to a cluster.                     |
+| [alpha] | commands currently in alpha and might change without notice.          |
 
 <!--mdtogo-->
 
 [pkg]: /reference/cli/pkg/
 [fn]: /reference/cli/fn/
 [live]: /reference/cli/live/
+[alpha]: /reference/cli/alpha/

site/reference/cli/alpha/README.md

@@ -0,0 +1,16 @@
+---
+title: "`alpha`"
+linkTitle: "alpha"
+type: docs
+weight: 4
+description: >
+   This command is currently in alpha and might change without notice.
+---
+
+<!--mdtogo:Short
+    This command is currently in alpha and might change without notice.
+-->
+
+<!--mdtogo:Long-->
+The `alpha` command group contains subcommands which are in alpha and might change without notice.
+<!--mdtogo-->