Skip to content

docs(loading): rewrite the loading guide around when, where and what - #2038

Draft
te6-in wants to merge 4 commits into
devfrom
docs/update-loading-guide
Draft

docs(loading): rewrite the loading guide around when, where and what#2038
te6-in wants to merge 4 commits into
devfrom
docs/update-loading-guide

Conversation

@te6-in

@te6-in te6-in commented Aug 19, 2026

Copy link
Copy Markdown
Member

No description provided.

te6-in and others added 4 commits August 19, 2026 19:48
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0124XAWsLt7VFtW671yiLwgG
The decision tree and the 2x2 selection matrix gave different answers for
the same inputs: the tree stopped at Skeleton whenever the final structure
was predictable, so Progress Bar was unreachable, while the matrix put
Progress Bar in exactly that quadrant.

Split them along their axis instead. The tree keeps only the three steps
that remove or localize loading and moves under "when"; choosing an element
now belongs solely to the matrix under "what".

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QPKFZiDCm9qazoEuRTGPCT
The rewrite lost a few things the old guide carried:

- "Loading Animation" as a usable element. It comes back as 에셋, named
  after the Asset type vocabulary result-section.mdx already uses, and this
  time it gets its own section instead of being referenced and never defined.
- What to reach for when a state toggle cannot take an optimistic update.
- Why an estimate matters past 10s — so the user can tell the system has
  not broken.

Also drop "전면 로딩은 사용하지 않습니다" from the page-transition case. The
전면 로딩 section allows it for work that takes over 3s and changes context,
which is exactly what a page transition can be.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QPKFZiDCm9qazoEuRTGPCT
Two sentences only announced what came next — that two questions decide the
element, and that the table below is where the choice is made. The bullets
and the table say both on their own.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QPKFZiDCm9qazoEuRTGPCT
@changeset-bot

changeset-bot Bot commented Aug 19, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 333a2d2

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@coderabbitai

coderabbitai Bot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 5ccf486d-651c-4543-8ac9-af1bff0789ac

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown
Contributor

Alpha Preview (Stackflow SPA)

@github-actions

Copy link
Copy Markdown
Contributor

Alpha Preview (Storybook)

@github-actions

Copy link
Copy Markdown
Contributor

Alpha Preview (Docs)

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant