Add documentation for the commands and remove mentions of session

Author: wolfo951

docs/_sidebar.md

@@ -10,6 +10,10 @@
   * [info](/docs/auth/info.md) 
   * [login](/docs/auth/login.md)
   * [logout](/docs/auth/logout.md)
+* [context](/docs/context/overview.md)
+  * [set](/docs/context/set.md)
+  * [clear](/docs/context/clear.md)
+  * [info](/docs/context/info.md)
 * [api](/docs/api.md)
 * [itwin](/docs/itwin/overview.md)
   * [create](/docs/itwin/create.md)

docs/context/clear.md

@@ -0,0 +1,10 @@
+# itp context clear
+
+Clear the cached context.
+
+## Examples
+
+```bash
+# Example 1: Clear the cached context
+itp context clear
+```

docs/context/info.md

@@ -0,0 +1,10 @@
+# itp context info
+
+Display the cached context.
+
+## Examples
+
+```bash
+# Example 1: Display the cached context
+itp context info
+```

docs/context/overview.md

@@ -0,0 +1,9 @@
+# itp context
+
+Work with iTwin CLI context.
+
+## Available Commands
+
+- [itp context set](set.md)
+- [itp context info](info.md)
+- [itp context clear](clear.md)

docs/context/set.md

@@ -0,0 +1,26 @@
+# itp context set
+
+Set a new cached context.
+
+## Options
+
+- **`--imodel-id`**  
+  The ID of the iModel to create a context for.  
+  **Type:** `string` **Required:** No
+
+- **`--itwin-id`**  
+  The ID of the iTwin to create a context for.  
+  **Type:** `string` **Required:** No
+
+## Examples
+
+```bash
+# Example 1: Set a new cached context using an iTwin ID
+itp context set --itwin-id 12345
+
+# Example 2: Set a new cached context using an iModel ID
+itp context set --imodel-id 67890
+
+# Example 3: Error when neither --itwin-id nor --imodel-id is provided
+itp context set
+```

src/commands/context/clear.ts

@@ -1,17 +1,17 @@
 import BaseCommand from "../../extensions/base-command.js";
 
 export default class ClearContext extends BaseCommand {
-    static description = "Clear the context of the current session.";
-  
+    static description = "Clear the cached context.";
+
     static examples = [
         {            
             command: `<%= config.bin %> <%= command.id %>`,
-            description: 'Example 1: Clear the context of the current session'
+            description: 'Example 1: Clear the cached context'
         }
     ];
 
     async run() {
         this.clearContext();      
         return this.logAndReturnResult({ result: "Context cleared." });
     }
-  }
+}

src/commands/context/info.ts

@@ -1,12 +1,12 @@
 import BaseCommand from "../../extensions/base-command.js";
 
 export default class InfoContext extends BaseCommand {
-    static description = "Display the current context of the session.";
+    static description = "Display the cached context.";
 
     static examples = [
         {
             command: `<%= config.bin %> <%= command.id %>`,
-            description: 'Example 1: Display the current context of the session'
+            description: 'Example 1: Display the cached context'
         }
     ];
 

src/commands/context/set.ts

@@ -5,12 +5,12 @@ import { Flags } from "@oclif/core";
 import BaseCommand from "../../extensions/base-command.js";
 
 export default class SetContext extends BaseCommand {
-    static description = "Create a new context for the current session.";
+    static description = "Set a new cached context.";
 
     static examples = [
         {
             command: `<%= config.bin %> <%= command.id %>`,
-            description: 'Example 1: Create a new context for the current session'
+            description: 'Example 1: Set a new cached context'
         }
     ];