update docs

Author: jahvon

docs/guide/executable.md

@@ -41,6 +41,27 @@ For instance, `flow test my-app` is equivalent to `flow validate my-app`. This a
 interaction with the CLI, making it easier to remember and use. 
 *See the [verb reference](../types/flowfile.md#verb-groups) for a list all verbs and their synonyms.*
 
+**Custom Verb Aliases**
+
+You can customize which verb aliases are available in your workspace by configuring `verbAliases` in your [workspace configuration](workspace.md#workspace-configuration). This allows you to:
+
+- **Use custom aliases**: Define your own preferred aliases for verbs
+- **Disable default aliases**: Set an empty map `{}` to disable all verb aliases
+- **Selective aliases**: Only enable specific aliases for certain verbs
+
+```yaml
+# In your workspace flow.yaml
+verbAliases:
+  run: ["exec", "start"]    # `run` executables can be called with `exec` or `start` 
+  build: ["compile"]        # `build` executables can be called with `compile`
+  # No entry for `test` means no aliases for test executables
+
+# To disable all verb aliases:
+verbAliases: {}
+```
+
+With the above configuration, `flow start my-app` would run a `run` executable, but `flow execute my-app` would fail because `execute` is no longer a valid alias.
+
 > [!TIP]
 > Create shell aliases for commonly used verbs to make running executables easier. For example:
 > ```shell

docs/guide/workspace.md

@@ -18,6 +18,27 @@ When a workspace is created, a [configuration](#workspace-configuration) file is
 
 The workspace configuration file is a YAML file that contains the configuration options for the workspace. This file is located in the root directory of the workspace and is named `flow.yaml`.
 
+```yaml
+# Example workspace configuration
+displayName: "My Project"
+description: "A sample Flow workspace"
+descriptionFile: README.md
+tags: ["development", "web"]
+verbAliases:
+  run: ["exec", "start"]
+  build: ["compile"]
+executables:
+  included: ["scripts/", "tools/"]
+  excluded: ["node_modules/", ".git/"]
+```
+
+**Key Configuration Options:**
+
+- **verbAliases**: Customize which verb aliases are available when running executables. Set to `{}` to disable all aliases. See [custom verb aliases](executable.md#custom-verb-aliases) for more details.
+- **executables**: Configure which directories to include or exclude when discovering executables.
+- **displayName**,  **description**, and **descriptionFile**: Used in the interactive UI and library views.
+- **tags**: Used for filtering workspaces.
+
 For more details about workspace configuration options, see [Workspace](../types/workspace.md).