CRITICAL: Handbook is barely usable in Safari on mac

Open
#3,207 2 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
25/100
Issue type
Bug
Clarity
Needs clarification
Activity status
Stale
Tech stack
typescript
Domain
documentation, web-dev

Research direction

Open the Handbook URL in Safari on macOS and reproduce the slowdown, crashes, and empty content while scrolling; compare the same pages in Chrome. Trace the rendering path used by the Handbook pages and measure the affected long-page behavior. Done means the Handbook pages scroll and render reliably in Safari without the reported failures.

Written by the indexing model from the issue text.

Description

In Safari (any version) on mac, Handbook is very slow. It looks like the long pages are somehow rendered dynamically and it's really bad in Safari. When scrolling, it often crashes or renders empty content that never appears anymore. Terrible user experience.

It's fine in Chrome.

Tested on MacBook Pro M2 Pro.

Page URL: https://www.typescriptlang.org/docs/handbook/

Issue: it's slow and barely usable

Dominant language
TypeScript
Stars
2.6k
Forks
1.5k
Avg merge
1d 12h
Merged PRs (30d)
5

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from microsoft/TypeScript-Website

All issues in microsoft/TypeScript-Website

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.