adding docs and suggested changes

ivan-tejero · rubenhoenle · commit 5e96f01f60e9 · 2025-07-17T11:41:05.000+02:00
diff --git a/docs/stackit_git.md b/docs/stackit_git.md
@@ -30,8 +30,6 @@ stackit git [flags]
 ### SEE ALSO
 
 * [stackit](./stackit.md)	 - Manage STACKIT resources using the command line
-* [stackit git create](./stackit_git_create.md)	 - Creates STACKIT Git instance
-* [stackit git delete](./stackit_git_delete.md)	 - Deletes STACKIT Git instance
-* [stackit git describe](./stackit_git_describe.md)	 - Describes STACKIT Git instance
-* [stackit git list](./stackit_git_list.md)	 - Lists all instances of STACKIT Git.
+* [stackit git flavor](./stackit_git_flavor.md)	 - Provides functionality for STACKIT Git flavors
+* [stackit git instance](./stackit_git_instance.md)	 - Provides functionality for STACKIT Git instances
 
diff --git a/docs/stackit_git_flavor.md b/docs/stackit_git_flavor.md
@@ -1,27 +1,19 @@
-## stackit git create
+## stackit git flavor
 
-Creates STACKIT Git instance
+Provides functionality for STACKIT Git flavors
 
 ### Synopsis
 
-Create a STACKIT Git instance by name.
+Provides functionality for STACKIT Git flavors.
 
 ```
-stackit git create [flags]
-```
-
-### Examples
-
-```
-  Create a instance with name 'my-new-instance'
-  $ stackit git create --name my-new-instance
+stackit git flavor [flags]
 ```
 
 ### Options
 
 ```
-  -h, --help          Help for "stackit git create"
-      --name string   The name of the instance.
+  -h, --help   Help for "stackit git flavor"
 ```
 
 ### Options inherited from parent commands
@@ -38,4 +30,5 @@ stackit git create [flags]
 ### SEE ALSO
 
 * [stackit git](./stackit_git.md)	 - Provides functionality for STACKIT Git
+* [stackit git flavor list](./stackit_git_flavor_list.md)	 - Lists instances flavors of STACKIT Git.
 
diff --git a/docs/stackit_git_flavor_list.md b/docs/stackit_git_flavor_list.md
@@ -0,0 +1,44 @@
+## stackit git flavor list
+
+Lists instances flavors of STACKIT Git.
+
+### Synopsis
+
+Lists instances flavors of STACKIT Git for the current project.
+
+```
+stackit git flavor list [flags]
+```
+
+### Examples
+
+```
+  List STACKIT Git flavors
+  $ stackit git flavor list
+
+  Lists up to 10 STACKIT Git flavors
+  $ stackit git flavor list --limit=10
+```
+
+### Options
+
+```
+  -h, --help        Help for "stackit git flavor list"
+      --limit int   Limit the output to the first n elements
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit git flavor](./stackit_git_flavor.md)	 - Provides functionality for STACKIT Git flavors
+
diff --git a/docs/stackit_git_instance.md b/docs/stackit_git_instance.md
@@ -0,0 +1,37 @@
+## stackit git instance
+
+Provides functionality for STACKIT Git instances
+
+### Synopsis
+
+Provides functionality for STACKIT Git instances.
+
+```
+stackit git instance [flags]
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit git instance"
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit git](./stackit_git.md)	 - Provides functionality for STACKIT Git
+* [stackit git instance create](./stackit_git_instance_create.md)	 - Creates STACKIT Git instance
+* [stackit git instance delete](./stackit_git_instance_delete.md)	 - Deletes STACKIT Git instance
+* [stackit git instance describe](./stackit_git_instance_describe.md)	 - Describes STACKIT Git instance
+* [stackit git instance list](./stackit_git_instance_list.md)	 - Lists all instances of STACKIT Git.
+
diff --git a/docs/stackit_git_instance_create.md b/docs/stackit_git_instance_create.md
@@ -0,0 +1,49 @@
+## stackit git instance create
+
+Creates STACKIT Git instance
+
+### Synopsis
+
+Create a STACKIT Git instance by name.
+
+```
+stackit git instance create [flags]
+```
+
+### Examples
+
+```
+  Create a instance with name 'my-new-instance'
+  $ stackit git instance create --name my-new-instance
+
+  Create a instance with name 'my-new-instance' and flavor
+  $ stackit git instance create --name my-new-instance --flavor git-100'
+
+  Create a instance with name 'my-new-instance' and acl
+  $ stackit git instance create --name my-new-instance --acl 1.1.1.1/1'
+```
+
+### Options
+
+```
+      --acl strings     Acl for the instance.
+      --flavor string   Flavor of the instance.
+  -h, --help            Help for "stackit git instance create"
+      --name string     The name of the instance.
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit git instance](./stackit_git_instance.md)	 - Provides functionality for STACKIT Git instances
+
diff --git a/docs/stackit_git_instance_delete.md b/docs/stackit_git_instance_delete.md
@@ -1,4 +1,4 @@
-## stackit git delete
+## stackit git instance delete
 
 Deletes STACKIT Git instance
 
@@ -7,20 +7,20 @@ Deletes STACKIT Git instance
 Deletes a STACKIT Git instance by its internal ID.
 
 ```
-stackit git delete INSTANCE_ID [flags]
+stackit git instance delete INSTANCE_ID [flags]
 ```
 
 ### Examples
 
 ```
   Delete a instance with ID "xxx"
-  $ stackit git delete xxx
+  $ stackit git instance delete xxx
 ```
 
 ### Options
 
 ```
-  -h, --help   Help for "stackit git delete"
+  -h, --help   Help for "stackit git instance delete"
 ```
 
 ### Options inherited from parent commands
@@ -36,5 +36,5 @@ stackit git delete INSTANCE_ID [flags]
 
 ### SEE ALSO
 
-* [stackit git](./stackit_git.md)	 - Provides functionality for STACKIT Git
+* [stackit git instance](./stackit_git_instance.md)	 - Provides functionality for STACKIT Git instances
 
diff --git a/docs/stackit_git_instance_describe.md b/docs/stackit_git_instance_describe.md
@@ -1,4 +1,4 @@
-## stackit git describe
+## stackit git instance describe
 
 Describes STACKIT Git instance
 
@@ -7,7 +7,7 @@ Describes STACKIT Git instance
 Describes a STACKIT Git instance by its internal ID.
 
 ```
-stackit git describe INSTANCE_ID [flags]
+stackit git instance describe INSTANCE_ID [flags]
 ```
 
 ### Examples
@@ -20,7 +20,7 @@ stackit git describe INSTANCE_ID [flags]
 ### Options
 
 ```
-  -h, --help   Help for "stackit git describe"
+  -h, --help   Help for "stackit git instance describe"
 ```
 
 ### Options inherited from parent commands
@@ -36,5 +36,5 @@ stackit git describe INSTANCE_ID [flags]
 
 ### SEE ALSO
 
-* [stackit git](./stackit_git.md)	 - Provides functionality for STACKIT Git
+* [stackit git instance](./stackit_git_instance.md)	 - Provides functionality for STACKIT Git instances
 
diff --git a/docs/stackit_git_instance_list.md b/docs/stackit_git_instance_list.md
@@ -1,4 +1,4 @@
-## stackit git list
+## stackit git instance list
 
 Lists all instances of STACKIT Git.
 
@@ -7,7 +7,7 @@ Lists all instances of STACKIT Git.
 Lists all instances of STACKIT Git for the current project.
 
 ```
-stackit git list [flags]
+stackit git instance list [flags]
 ```
 
 ### Examples
@@ -23,7 +23,7 @@ stackit git list [flags]
 ### Options
 
 ```
-  -h, --help        Help for "stackit git list"
+  -h, --help        Help for "stackit git instance list"
       --limit int   Limit the output to the first n elements
 ```
 
@@ -40,5 +40,5 @@ stackit git list [flags]
 
 ### SEE ALSO
 
-* [stackit git](./stackit_git.md)	 - Provides functionality for STACKIT Git
+* [stackit git instance](./stackit_git_instance.md)	 - Provides functionality for STACKIT Git instances
 
diff --git a/internal/cmd/git/flavor/flavor.go b/internal/cmd/git/flavor/flavor.go
@@ -1,4 +1,4 @@
-package git
+package flavor
 
 import (
 	"github.com/stackitcloud/stackit-cli/internal/cmd/git/flavor/list"
@@ -12,8 +12,8 @@ import (
 func NewCmd(params *params.CmdParams) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "flavor",
-		Short: "Provides functionality for STACKIT Git",
-		Long:  "Provides functionality for STACKIT Git.",
+		Short: "Provides functionality for STACKIT Git flavors",
+		Long:  "Provides functionality for STACKIT Git flavors.",
 		Args:  args.NoArgs,
 		Run:   utils.CmdHelp,
 	}
diff --git a/internal/cmd/git/git.go b/internal/cmd/git/git.go
@@ -1,8 +1,8 @@
 package git
 
 import (
-	flavor "github.com/stackitcloud/stackit-cli/internal/cmd/git/flavor"
-	instance "github.com/stackitcloud/stackit-cli/internal/cmd/git/instance"
+	"github.com/stackitcloud/stackit-cli/internal/cmd/git/flavor"
+	"github.com/stackitcloud/stackit-cli/internal/cmd/git/instance"
 	"github.com/stackitcloud/stackit-cli/internal/cmd/params"
 	"github.com/stackitcloud/stackit-cli/internal/pkg/args"
 	"github.com/stackitcloud/stackit-cli/internal/pkg/utils"
diff --git a/internal/cmd/git/instance/instance.go b/internal/cmd/git/instance/instance.go
@@ -1,4 +1,4 @@
-package git
+package instance
 
 import (
 	"github.com/stackitcloud/stackit-cli/internal/cmd/git/instance/create"
@@ -15,8 +15,8 @@ import (
 func NewCmd(params *params.CmdParams) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "instance",
-		Short: "Provides functionality for STACKIT Git",
-		Long:  "Provides functionality for STACKIT Git.",
+		Short: "Provides functionality for STACKIT Git instances",
+		Long:  "Provides functionality for STACKIT Git instances.",
 		Args:  args.NoArgs,
 		Run:   utils.CmdHelp,
 	}
