Added openHelp command, capitalize resource role

Author: mvcninja

packages/core/package.json

@@ -2006,7 +2006,8 @@
                 },
                 {
                     "command": "aws.docdb.createCluster",
-                    "when": "view == aws.explorer && viewItem == awsDocDBNode"
+                    "when": "view == aws.explorer && viewItem == awsDocDBNode",
+                    "group": "0@1"
                 },
                 {
                     "command": "aws.docdb.startCluster",
@@ -2073,6 +2074,10 @@
                     "when": "viewItem =~ /^awsDocDB-/",
                     "group": "0@1"
                 },
+                {
+                    "command": "aws.docdb.openHelp",
+                    "when": "viewItem == awsDocDBNode"
+                },
                 {
                     "command": "aws.docdb.copyEndpoint",
                     "when": "viewItem =~ /^awsDocDB-/",
@@ -3748,6 +3753,17 @@
                     }
                 }
             },
+            {
+                "command": "aws.docdb.openHelp",
+                "title": "%AWS.command.docdb.openHelp%",
+                "category": "%AWS.title%",
+                "enablement": "(isCloud9 || !aws.isWebExtHost)",
+                "cloud9": {
+                    "cn": {
+                        "category": "%AWS.title.cn%"
+                    }
+                }
+            },
             {
                 "command": "aws.docdb.copyEndpoint",
                 "title": "%AWS.command.docdb.copyEndpoint%",

packages/core/package.nls.json

@@ -212,6 +212,7 @@
     "AWS.command.docdb.stopCluster": "Stop Cluster",
     "AWS.command.docdb.tags": "Tags...",
     "AWS.command.docdb.open": "Open in Browser",
+    "AWS.command.docdb.openHelp": "Open Getting Started Guide",
     "AWS.command.docdb.copyEndpoint": "Copy Endpoint",
     "AWS.command.docdb.addRegion": "Add region...",
     "AWS.command.resources.copyIdentifier": "Copy Identifier",

packages/core/src/docdb/activation.ts

@@ -21,6 +21,7 @@ import { modifyInstance } from './commands/modifyInstance'
 import { rebootInstance } from './commands/rebootInstance'
 import { renameInstance } from './commands/renameInstance'
 import { addTag, listTags, removeTag } from './commands/tagCommands'
+import { env, Uri } from 'vscode'
 
 /**
  * Activates DocumentDB components.
@@ -88,6 +89,11 @@ export async function activate(ctx: ExtContext): Promise<void> {
             await node?.openInBrowser()
         }),
 
+        Commands.register('aws.docdb.openHelp', async (node?: DBResourceNode) => {
+            const url = Uri.parse('https://docs.aws.amazon.com/documentdb/latest/developerguide/get-started-guide.html')
+            await env.openExternal(url)
+        }),
+
         Commands.register('aws.docdb.copyEndpoint', async (node?: DBResourceNode) => {
             await node?.copyEndpoint()
         })

packages/core/src/docdb/explorer/dbClusterNode.ts

@@ -17,6 +17,7 @@ import { DBInstanceNode } from './dbInstanceNode'
 import { PlaceholderNode } from '../../shared/treeview/nodes/placeholderNode'
 import { DBInstance, DocumentDBClient } from '../../shared/clients/docdbClient'
 import { DocDBContext } from './docdbContext'
+import { toTitleCase } from '../../shared'
 
 export type DBClusterRole = 'global' | 'regional' | 'primary' | 'secondary'
 
@@ -83,10 +84,11 @@ export class DBClusterNode extends DBResourceNode {
     }
 
     public getDescription(): string | boolean {
+        const role = toTitleCase(this.clusterRole)
         if (!this.isAvailable) {
-            return `${this.clusterRole} cluster • ${this.status}`
+            return `${role} cluster • ${toTitleCase(this.status ?? ' ')}`
         }
-        return `${this.clusterRole} cluster`
+        return `${role} cluster`
     }
 
     public async createInstance(request: CreateDBInstanceMessage): Promise<DBInstance | undefined> {

packages/core/src/docdb/explorer/dbElasticClusterNode.ts

@@ -44,9 +44,9 @@ export class DBElasticClusterNode extends DBResourceNode {
 
     public getDescription(): string | boolean {
         if (!this.isAvailable) {
-            return `elastic cluster • ${this.status}`
+            return `Elastic cluster • ${this.status}`
         }
-        return 'elastic cluster'
+        return 'Elastic cluster'
     }
 
     public async deleteCluster(finalSnapshotId: string | undefined): Promise<DBElasticCluster | undefined> {

packages/core/src/docdb/explorer/dbGlobalClusterNode.ts

@@ -43,7 +43,7 @@ export class DBGlobalClusterNode extends DBResourceNode {
         this.name = cluster.GlobalClusterIdentifier ?? ''
         this.contextValue = this.getContext()
         this.iconPath = new vscode.ThemeIcon('globe') //TODO: determine icon for global cluster
-        this.description = 'global cluster'
+        this.description = 'Global cluster'
         this.tooltip = `${this.name}\nEngine: ${this.cluster.EngineVersion}\nStatus: ${this.cluster.Status} (read-only)`
     }
 

packages/core/src/docdb/explorer/dbInstanceNode.ts

@@ -11,6 +11,7 @@ import { DBResourceNode } from './dbResourceNode'
 import { DBClusterNode } from './dbClusterNode'
 import { ModifyDBInstanceMessage } from '@aws-sdk/client-docdb'
 import { copyToClipboard } from '../../shared/utilities/messages'
+import { toTitleCase } from '../../shared'
 
 /**
  * An AWS Explorer node representing a DocumentDB instance.
@@ -31,9 +32,9 @@ export class DBInstanceNode extends DBResourceNode {
     }
 
     private makeDescription(): string {
-        const type = this.instance.IsClusterWriter ? 'primary' : 'replica'
+        const type = this.instance.IsClusterWriter ? 'Primary' : 'Replica'
         if (this.getContext() !== DocDBContext.InstanceAvailable) {
-            return `${this.status} ${type} instance`
+            return `${toTitleCase(this.status ?? ' ')} ${type} instance`
         }
         return `${type} instance • ${this.instance.DBInstanceClass}`
     }