Skip to content

Tighten docs/08-first-run-and-updates to match the Hub-first onboarding path #11

@RichardGeorgeDavis

Description

@RichardGeorgeDavis

Summary

Tighten docs/08-first-run-and-updates.md so the Hub-first onboarding path matches the root README.

Problem statement

The root README now gives a clear "try Workspace Hub first" path, but the deeper first-run guide still leads with a broad questionnaire and profile model. That makes the public onboarding story less consistent than it should be.

Affected area

  • docs/08-first-run-and-updates.md
  • Any nearby cross-links that should reflect the same onboarding order

Expected outcome

The first-run guide should make it obvious that:

  • trying Workspace Hub is the fastest concrete path for most readers
  • the broader workspace/profile questions come after that initial path
  • the README and first-run guide tell the same onboarding story

Constraints or non-goals

  • Keep the existing mixed-stack and profile guidance
  • Do not rewrite the whole document unless needed
  • Focus on ordering, framing, and contributor readability

Verification

  • Read the root README and docs/08-first-run-and-updates.md back to back
  • Confirm the onboarding flow feels consistent
  • Confirm a new reader can tell what to try first without reading the full doc set

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomershelp wantedExtra attention is needed

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions