Added examples from /docs to command help menus. (#77)

* Added examples from /docs to command help menus.

Author: Nadegamra

docs/imodel/populate.md

@@ -33,7 +33,7 @@ itp imodel populate --imodel-id c2d3e4f5-6789-01ab-cdef-2345678901bc --file site
 # Example 3: Synchronizing CSV and IFC Files
 itp imodel populate --imodel-id d3e4f5g6-7890-12ab-cdef-3456789012cd --file data1.csv --file data2.csv --file model.ifc
 
-# Example: Synchronizing Revit and DGN Files
+# Example 4: Synchronizing Revit and DGN Files
 itp imodel populate --imodel-id i9j0k1l2-3456-78ab-cdef-9012345678ij --file model.rvt --file design.dgn
 ```
 

docs/user/info.md

@@ -11,7 +11,7 @@ Retrieve information about specific users based on their user IDs.
 ## Examples
 
 ```bash
-# Example: Retrieve information about specific users by their user IDs
+# Example 1: Retrieve information about specific users by their user IDs
 itp user info --user-id user1-id --user-id user2-id --user-id user3-id
 ```
 

src/commands/access-control/group/create.ts

@@ -10,6 +10,13 @@ import BaseCommand from "../../../extensions/base-command.js";
 export default class CreateAccessControlGroup extends BaseCommand {
     static description = 'Create a new group for an iTwin.';
 
+    static examples = [
+      {
+        command: `<%= config.bin %> <%= command.id %> --itwin-id ad0ba809-9241-48ad-9eb0-c8038c1a1d51 --name "Engineering Team" --description "Group handling engineering tasks"`,
+        description: 'Example 1:'
+      }
+    ];
+
     static flags = {
       description: Flags.string({
         char: 'd',

src/commands/access-control/group/delete.ts

@@ -9,7 +9,14 @@ import BaseCommand from "../../../extensions/base-command.js";
 
 export default class DeleteAccessControlGroup extends BaseCommand {
     static description = 'Delete an existing group from an iTwin.';
-  
+
+    static examples = [
+      {
+        command: `<%= config.bin %> <%= command.id %> --itwin-id ad0ba809-9241-48ad-9eb0-c8038c1a1d51 --group-id bf4d8b36-25d7-4b72-b38b-12c1f0325f42`,
+        description: 'Example 1:'
+      }
+    ];
+
     static flags = {
       "group-id": Flags.string({
         char: 'g',

src/commands/access-control/group/info.ts

@@ -9,7 +9,14 @@ import BaseCommand from "../../../extensions/base-command.js";
 
 export default class AccessControlGroupInfo extends BaseCommand {
     static description = 'Retrieve details about a specific group in an iTwin.';
-  
+
+    static examples = [
+      {
+        command: `<%= config.bin %> <%= command.id %> --itwin-id ad0ba809-9241-48ad-9eb0-c8038c1a1d51 --group-id bf4d8b36-25d7-4b72-b38b-12c1f0325f42`,
+        description: 'Example 1:'
+      }
+    ];
+
     static flags = {
       "group-id": Flags.string({
         char: 'g',

src/commands/access-control/group/list.ts

@@ -9,7 +9,14 @@ import BaseCommand from "../../../extensions/base-command.js";
 
 export default class ListAccessControlGroups extends BaseCommand {
     static description = 'List all groups for a specific iTwin.';
-  
+
+    static examples = [
+      {
+        command: `<%= config.bin %> <%= command.id %> --itwin-id ad0ba809-9241-48ad-9eb0-c8038c1a1d51`,
+        description: 'Example 1:'
+      }
+    ];
+
     static flags = {
       "itwin-id": Flags.string({
         char: 'i',

src/commands/access-control/group/update.ts

@@ -10,6 +10,17 @@ import BaseCommand from "../../../extensions/base-command.js";
 export default class UpdateAccessControlGroup extends BaseCommand {
     static description = 'Update the details of an existing group in an iTwin.';
 
+    static examples = [
+      {
+        command: `<%= config.bin %> <%= command.id %> --itwin-id ad0ba809-9241-48ad-9eb0-c8038c1a1d51 --group-id bf4d8b36-25d7-4b72-b38b-12c1f0325f42 --name "Updated Engineering Team" --description "Updated description"`,
+        description: 'Example 1: Update group name and description'
+      },
+      {
+        command: `<%= config.bin %> <%= command.id %> --itwin-id ad0ba809-9241-48ad-9eb0-c8038c1a1d51 --group-id bf4d8b36-25d7-4b72-b38b-12c1f0325f42 --members john.doe@example.com --members jane.doe@example.com --imsGroups "Sample IMS Group" --imsGroups "Sample IMS Group"`,
+        description: 'Example 2: Update group members and IMS groups'
+      }
+    ];
+      
     static flags = {
       description: Flags.string({
         char: 'd',

src/commands/access-control/member/group/add.ts

@@ -3,18 +3,18 @@
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
 
-import { Command, Flags } from "@oclif/core";
+import { Flags } from "@oclif/core";
 
 import BaseCommand from "../../../../extensions/base-command.js";
 import { GroupMember } from "../../../../services/access-control-client/models/group.js";
 
 export default class AddGroupMembers extends BaseCommand {
     static description = 'Add one or more groups as members to an iTwin.';
 
-    static examples: Command.Example[] = [
+    static examples = [
       {
-        command: 'itp access-control member group add --itwin-id "ad0ba809-9241-48ad-9eb0-c8038c1a1d51" --groups \'[{"groupId": "group1-id", "roleIds": ["5abbfcef-0eab-472a-b5f5-5c5a43df34b1", "83ee0d80-dea3-495a-b6c0-7bb102ebbcc3"]}, {"groupId": "group2-id", "roleIds": ["5abbfcef-0eab-472a-b5f5-5c5a43df34b1"]}]\',',
-        description: 'Add one or more groups as members to an iTwin.'
+        command: `<%= config.bin %> <%= command.id %> --itwin-id "ad0ba809-9241-48ad-9eb0-c8038c1a1d51" --groups '[{"groupId": "group1-id", "roleIds": ["5abbfcef-0eab-472a-b5f5-5c5a43df34b1", "83ee0d80-dea3-495a-b6c0-7bb102ebbcc3"]}, {"groupId": "group2-id", "roleIds": ["5abbfcef-0eab-472a-b5f5-5c5a43df34b1"]}]',`,
+        description: 'Example 1: Add one or more groups as members to an iTwin.'
       }
     ];
 

src/commands/access-control/member/group/delete.ts

@@ -9,7 +9,14 @@ import BaseCommand from "../../../../extensions/base-command.js";
 
 export default class DeleteGroupMember extends BaseCommand {
     static description = 'Remove a group from an iTwin.';
-  
+
+    static examples = [
+      {
+        command: `<%= config.bin %> <%= command.id %> --itwin-id ad0ba809-9241-48ad-9eb0-c8038c1a1d51 --group-id group1-id`,
+        description: 'Example 1:'
+      }
+    ];
+
     static flags = {
       "group-id": Flags.string({
         char: 'g',

src/commands/access-control/member/group/info.ts

@@ -9,7 +9,14 @@ import BaseCommand from "../../../../extensions/base-command.js";
 
 export default class InfoGroupMember extends BaseCommand {
     static description = 'Retrieve details about a specific group member in an iTwin.';
-  
+
+    static examples = [
+      {
+        command: `<%= config.bin %> <%= command.id %> --itwin-id ad0ba809-9241-48ad-9eb0-c8038c1a1d51 --group-id group1-id`,
+        description: 'Example 1:'
+      }
+    ];
+
     static flags = {
       "group-id": Flags.string({
         char: 'g',