microsoft / microsoft/TypeScript-Website

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.

Dominant language
TypeScript
Stars
2.6k
Forks
1.5k
Avg merge
2d 2h
Merged PRs (30d)
7

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

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.

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.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.