docs: tidy up readme

README.md

@@ -11,7 +11,7 @@
 <p align="center">
     <b>flow</b> is a customizable and interactive CLI automation tool designed to streamline how you manage and run local 
     development and operations workflows. It uses executable YAML configurations, organized across workspaces and namespaces, 
-    for tasks like running scripts, transforming APIs, or generating file systems from templates. <a href="https://charm.sh">Charming</a> interactive TUI included!
+    for tasks like running scripts, transforming APIs, or generating file systems from templates. <i>Charming</i>, interactive TUI included!
 </p>
 
 <p align="center"><b>Learn more at <a href="https://flowexec.io">flowexec.io</a></b></p>

docs/README.md

@@ -12,13 +12,12 @@ operations workflows.
 
 ## Features
 
-- **Workflow Runner**: Easily define, manage, and run your [workflows](guide/executable.md) from the command line. Example use cases includes running a set of scripts, opening an application after running setup tasks,
-  and rendering a markdown document that is dynamically generated from data in an external system.
-- **Secret Management**: Safely store sensitive secrets in an encrypted local [vault](guide/vault.md), easily referencable in your executable configurations.
+- **Task Runner**: Easily define, manage, and run your tasks (called [executables](guide/executable.md)) from the command line.
+- **Secret Management**: Safely store sensitive secrets in a secure local [vault](guide/vault.md), easily referencable in your executable configurations.
 - **Input Handling**: Pass values into executables via environment variables defined by configuration, flags, or interactive prompts, ensuring your workflows are flexible and easy to use.
 - **Executable Organization**: Group your executables into workspace and namespace, making them easily discoverable and accessible from anywhere on your system. Tag your executables and workspaces for easy filtering and searching.
 - **Customizable TUI**: Enjoy a seamless [TUI experience](guide/interactive.md) with log formatting, log archiving, and execution notifications, enhancing your productivity.
-- **Generate w/ Templates and Comments**: Automatically generate executable configurations from [flow file templates](guide/templating.md) or comments in your script files, making it easy to onboard new executables.
+- **Generate w/ Templates and Comments**: Automatically generate executable configurations and workspace scaffolding from [flow file templates](guide/templating.md) or comments in your script files, making it easy to onboard new executables.
 - **Comprehensive Commands**:
     - `get` and `list`: Retrieve and display executable details, formatted as markdown documentation, YAML, or JSON.
     - `library`: Access a fully searchable and interactive TUI for running and exploring executables.
@@ -85,10 +84,10 @@ suggestions. You can add the following comment to the top of your flow files to
 
 See the [schemas](../schemas/) directory all available schemas.
 
-### Running and managing workflows
+### Running and managing executables
 
-The main command for running workflows is `flow exec`. This command will execute the workflow with the provided
-executable ID. `exec` can be replaced with any verb known to flow but should match the verb defined in the executable's
-definition or an alias of the verb.
+The main command for running executables is `flow exec`. This command will execute the workflow with the provided
+executable ID. `exec` can be replaced with any verb known to flow but should match the verb defined in the flow file
+configurations or an alias of that verb.
 
 As you make changes to executables on your system, you can run `flow sync` to trigger a re-index of your executables.