Skip to content

Polish capability-panel copy for contributor comprehension #9

Description

@RichardGeorgeDavis

Summary

Improve Workspace Hub capability-panel copy so a first-time contributor can understand it without deep maintainer context.

Problem statement

The capability panel exposes useful workspace state, but terms such as reference-only, ability, and core service still assume too much prior context.

Affected area

  • Workspace Hub capability panel copy
  • Supporting docs where those terms are introduced

Expected outcome

Revise the panel wording so contributors can quickly understand:

  • what each capability category means
  • what is installed vs. reference-only
  • what is safe to inspect vs. what is workspace-owned runtime functionality

Constraints or non-goals

  • Keep the current capability model
  • No backend schema changes unless clearly necessary
  • Focus on copy, framing, and contributor comprehension

Verification

  • Open the capability panel as a new reader
  • Confirm the categories are understandable without reading deep architecture docs first
  • Confirm docs remain consistent with the UI wording

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    designUI copy, layout, visual polish, or empty-state qualityhelp wantedExtra attention is neededworkspace-hubUI, API, runtime, or tests inside repos/workspace-hub/

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions