feat(rdb): add short for openapi groups and cli resources (#1191)

Author: scaleway-bot

cmd/scw/testdata/test-all-usage-rdb-certificate-usage.golden

@@ -1,5 +1,7 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
+TLS certificate used by your instance.
+
 USAGE:
   scw rdb certificate <command>
 

cmd/scw/testdata/test-all-usage-rdb-log-usage.golden

@@ -1,5 +1,7 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
+Logs generated by your instance.
+
 USAGE:
   scw rdb log <command>
 

cmd/scw/testdata/test-all-usage-rdb-usage.golden

@@ -6,17 +6,26 @@ USAGE:
   scw rdb <command>
 
 AVAILABLE COMMANDS:
-  acl         
-  backup      
-  certificate 
-  database    
-  engine      
-  instance    
-  log         
-  node-type   
-  privilege   
-  settings    
-  user        
+  acl         Network Access Control List allows to control network in and out traffic by setting up ACL rules
+
+  backup      Backups are extracted data of your database at a given time
+
+  certificate TLS certificate used by your instance
+  database    Manage logical databases on your instance
+
+  engine      Software that stores and retrieves data from a database
+
+  instance    A Database Instance is composed of one or more Nodes, depending of the is_ha_cluster setting
+
+  log         Logs generated by your instance
+  node-type   Node types powering your instance
+
+  privilege   Define some privileges to a user on a specific database
+
+  settings    Instance Settings are tunables of Database Engines
+
+  user        Manage users on your instance
+
 
 FLAGS:
   -h, --help   help for rdb

internal/namespaces/rdb/v1/rdb_cli.go

@@ -77,7 +77,8 @@ func rdbRoot() *core.Command {
 
 func rdbBackup() *core.Command {
 	return &core.Command{
-		Short: ``,
+		Short: `Backups are extracted data of your database at a given time
+`,
 		Long: `Save and restore backups of your database instance.
 `,
 		Namespace: "rdb",
@@ -87,7 +88,8 @@ func rdbBackup() *core.Command {
 
 func rdbEngine() *core.Command {
 	return &core.Command{
-		Short: ``,
+		Short: `Software that stores and retrieves data from a database
+`,
 		Long: `Software that stores and retrieves data from a database. Each database engine has a name and versions.
 `,
 		Namespace: "rdb",
@@ -97,7 +99,8 @@ func rdbEngine() *core.Command {
 
 func rdbInstance() *core.Command {
 	return &core.Command{
-		Short: ``,
+		Short: `A Database Instance is composed of one or more Nodes, depending of the is_ha_cluster setting
+`,
 		Long: `A Database Instance is composed of one or more Nodes, depending of the is_ha_cluster setting. Autohealing is enabled by default for HA clusters. Database automated backup is enabled by default in order to prevent data loss.
 `,
 		Namespace: "rdb",
@@ -107,7 +110,8 @@ func rdbInstance() *core.Command {
 
 func rdbACL() *core.Command {
 	return &core.Command{
-		Short: ``,
+		Short: `Network Access Control List allows to control network in and out traffic by setting up ACL rules
+`,
 		Long: `Network Access Control List allows to control network in and out traffic by setting up ACL rules. ACL rules could be created, edited, deleted
 `,
 		Namespace: "rdb",
@@ -117,7 +121,8 @@ func rdbACL() *core.Command {
 
 func rdbSettings() *core.Command {
 	return &core.Command{
-		Short: ``,
+		Short: `Instance Settings are tunables of Database Engines
+`,
 		Long: `Instance Settings are tunables of Database Engines. Available settings depend on the database engine and its version.
 `,
 		Namespace: "rdb",
@@ -127,7 +132,8 @@ func rdbSettings() *core.Command {
 
 func rdbPrivilege() *core.Command {
 	return &core.Command{
-		Short: ``,
+		Short: `Define some privileges to a user on a specific database
+`,
 		Long: `Define some privileges to a user on a specific database.
 `,
 		Namespace: "rdb",
@@ -137,7 +143,8 @@ func rdbPrivilege() *core.Command {
 
 func rdbUser() *core.Command {
 	return &core.Command{
-		Short: ``,
+		Short: `Manage users on your instance
+`,
 		Long: `Manage users on your instance
 `,
 		Namespace: "rdb",
@@ -147,7 +154,8 @@ func rdbUser() *core.Command {
 
 func rdbDatabase() *core.Command {
 	return &core.Command{
-		Short: ``,
+		Short: `Manage logical databases on your instance
+`,
 		Long: `Manage logical databases on your instance
 `,
 		Namespace: "rdb",
@@ -157,7 +165,8 @@ func rdbDatabase() *core.Command {
 
 func rdbNodeType() *core.Command {
 	return &core.Command{
-		Short: ``,
+		Short: `Node types powering your instance
+`,
 		Long: `Node types powering your instance
 `,
 		Namespace: "rdb",
@@ -167,17 +176,17 @@ func rdbNodeType() *core.Command {
 
 func rdbLog() *core.Command {
 	return &core.Command{
-		Short:     ``,
-		Long:      ``,
+		Short:     `Logs generated by your instance`,
+		Long:      `Logs generated by your instance.`,
 		Namespace: "rdb",
 		Resource:  "log",
 	}
 }
 
 func rdbCertificate() *core.Command {
 	return &core.Command{
-		Short:     ``,
-		Long:      ``,
+		Short:     `TLS certificate used by your instance`,
+		Long:      `TLS certificate used by your instance.`,
 		Namespace: "rdb",
 		Resource:  "certificate",
 	}