Simplify workspace extension documentation

- Updated workspace README intro text to be more concise and clear
- Changed "include several types that work together through shared state management" to "can be grouped into these types"
- Restored workspace action menu items content after merge

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: hifi-phil

16/umbraco-cms/customizing/extending-overview/extension-types/workspaces/README.md

@@ -5,11 +5,11 @@ description: >-
 
 # Extension Types: Workspaces
 
-Workspace extensions provide functionality that operates within specific workspace environments, such as document editing, media management, or member editing. These extensions can communicate through shared workspace contexts to create cohesive, integrated functionality.
+Workspace extensions are specialized components that enhance Umbraco's editing environments for documents, media, and members. They share state through workspace contexts, enabling coordinated functionality like synchronized actions, real-time status updates, and seamless data flow between different parts of the editing interface.
 
 ## Available Extension Types
 
-Workspace extensions include several types that work together through shared state management:
+Workspace extensions can be grouped into these types:
 
 ### Core Extensions
 - **[Workspace Context](workspace-context.md)** - Provides shared state management and communication between workspace extensions
@@ -27,10 +27,11 @@ Workspace extensions include several types that work together through shared sta
 
 Workspace extensions communicate through shared contexts using these patterns:
 
-1. **Workspace Context** manages centralized state using observables that automatically notify subscribers of changes
-2. **Workspace Actions** consume the context to modify state when users interact with buttons or menu items
-3. **Workspace Views** observe context state to automatically update their UI when data changes  
-4. **Footer Apps** monitor context state to display real-time status information
+1. **[Workspace Context](workspace-context.md)** manages centralized state using observables that automatically notify subscribers of changes
+2. **[Workspace Actions](workspace-editor-actions.md)** consume the context to modify state when users interact with buttons or menu items
+3. **[Workspace Actions Menu Items](workspace-action-menu-items.md)** add additional options for workspace actions
+4. **[Workspace Views](workspace-views.md)** observe context state to automatically update their UI when data changes  
+5. **[Footer Apps](workspace-footer-apps.md)** monitor context state to display real-time status information
 
 ### Communication Flow
 
@@ -44,16 +45,6 @@ Workspace Views (State Display)
 Footer Apps (Status Monitoring)
 ```
 
-## Getting Started
-
-To create a complete workspace extension system:
-
-1. **Start with a [Workspace Context](workspace-context.md)** to provide shared state management
-2. **Add [Workspace Actions](workspace-editor-actions.md)** for primary user interactions
-3. **Create [Workspace Views](workspace-views.md)** for dedicated editing interfaces
-4. **Include [Footer Apps](workspace-footer-apps.md)** for persistent status information
-5. **Extend actions with [Menu Items](workspace-action-menu-items.md)** for additional functionality
-
 {% hint style="info" %}
 All workspace extensions are automatically scoped to their workspace instance, ensuring that extensions in different workspaces cannot interfere with each other.
 {% endhint %}

16/umbraco-cms/customizing/extending-overview/extension-types/workspaces/workspace-action-menu-items.md

@@ -7,18 +7,6 @@ description: >-
 
 Workspace Action Menu Items extend existing workspace actions by adding dropdown menu options. They provide secondary functionality that relates to the primary action without cluttering the workspace footer.
 
-## Purpose
-
-Action Menu Items provide:
-- **Secondary actions** that extend primary workspace actions
-- **Grouped functionality** under a single action button
-- **Progressive disclosure** for related operations
-- **Context integration** with workspace state
-
-{% hint style="info" %}
-Action Menu Items are associated with specific Workspace Actions using the `forWorkspaceActions` property.
-{% endhint %}
-
 ## Manifest
 
 {% code caption="manifest.ts" %}
@@ -47,7 +35,7 @@ Action Menu Items are associated with specific Workspace Actions using the `forW
 
 ## Implementation
 
-Create a workspace action menu item by extending `UmbWorkspaceActionMenuItemBase` and implementing the `execute` method. This provides the functionality that runs when users select the menu item:
+Create a workspace action menu item by extending `UmbWorkspaceActionMenuItemBase` and implementing the `execute` method. This provides the functionality that runs when users interacts with the menu item:
 
 {% code caption="reset-counter-menu-item.action.ts" %}
 ```typescript
@@ -72,7 +60,7 @@ export const api = ExampleResetCounterMenuItemAction;
 
 ## Action Relationship
 
-Menu items create dropdown menus for their associated actions:
+Menu items display a dropdown menu for their associated actions:
 
 ### Primary Action
 ```typescript
@@ -100,48 +88,4 @@ Menu items create dropdown menus for their associated actions:
 	forWorkspaceActions: 'example.workspaceAction.save',
 	meta: { label: 'Save as Draft' },
 }
-```
-
-## Use Cases
-
-### Alternative Operations
-Provide different ways to perform related actions:
-```typescript
-// Primary: Quick save
-// Menu: Save and close, Save as template, Save and publish
-```
-
-### Destructive Actions
-Keep dangerous operations in dropdown menus:
-```typescript
-// Primary: Edit
-// Menu: Delete, Archive, Reset
-```
-
-### Context-Specific Options
-Add options that depend on entity state:
-```typescript
-override async execute() {
-	const entityContext = await this.getContext(ENTITY_CONTEXT);
-	
-	if (entityContext.isDraft()) {
-		await entityContext.saveAsDraft();
-	} else {
-		await entityContext.saveAndPublish();
-	}
-}
-```
-
-## Best Practices
-
-### Related Functionality
-Only group actions that are logically related to the primary action.
-
-### Clear Labels
-Use descriptive labels that clearly indicate the menu item's purpose.
-
-### Appropriate Ordering
-Use weight to order menu items by importance or frequency of use.
-
-### Context Dependencies
-Always check context availability before performing operations.
+```