Skip to content

[plan] Reorder Quick Start 'What's next?' section and make Public Preview notice more prominent on home page #43691

Closed as not planned

Description

@github-actions

Objective

Reorder the "What's next?" section in Quick Start to lead with simpler follow-up steps before the 19-part blog series, and make the "Public Preview" notice more prominent on the home page.

Context

Discussion #43686 (Documentation Noob Tester report) flagged two related UX issues:

  1. "What's next?" leads with a 19-part blog series — overwhelming for a brand-new user. Simpler next steps like "Creating Workflows" or "How Workflows Work" should come first.
  2. "Public Preview" warning is easy to miss on the home page — appears in small text beneath the tagline, but is a significant caveat for production use.

Screenshot (home page): https://github.com/github/gh-aw/blob/assets/Documentation-Noob-Tester/d9053c0923f8bd97c565aab871a9b9a13c8f6e027b422326cf397b880dabf530.png?raw=true

Files to Modify

  • docs/src/content/docs/setup/quick-start.mdx (reorder "What's next?" links)
  • docs/src/content/docs/index.mdx (elevate Public Preview notice)
Implementation Plan

Approach

Fix 1 — Reorder "What's next?"

  1. Open quick-start.mdx and find the "What's next?" / next steps section.
  2. Reorder links/cards so that beginner-friendly destinations (e.g., "Creating Workflows", "How Workflows Work") appear before the blog series link.
  3. The blog series link should remain — just move it to the end of the list.

Fix 2 — More prominent Public Preview notice on home page

  1. Open docs/src/content/docs/index.mdx.
  2. Locate the existing "Public Preview" text.
  3. Elevate it using a Starlight <Aside type="caution"> or similar callout component so it is visually prominent, rather than appearing as small body text.

Files to Modify

  • docs/src/content/docs/setup/quick-start.mdx
  • docs/src/content/docs/index.mdx

Acceptance Criteria

  • "What's next?" in Quick Start leads with simpler follow-up steps; blog series is last
  • The Public Preview notice on the home page uses a visible callout/badge that cannot be missed
  • Both pages render correctly (no broken MDX/markdown)

Generated by 📋 Plan Command · 27.1 AIC · ⌖ 10.7 AIC · ⊞ 4.9K · ◷
Comment /plan to run again

  • expires on Jul 7, 2026, 9:34 PM UTC-08:00

Activity

  1. github-actions commented on Jul 8, 2026

    @github-actions
    ContributorAuthor

    This issue was automatically closed because it expired on 2026-07-08T05:34:56.693Z.

    Closed by Workflow

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

Metadata

Metadata

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions