Skip to content

ToC less readable on wide screen (redesign) #9019

Closed

Description

@MikeMcC399

In the redesigned Deprecated APIs the Table of Contents is less readable on a wide screen display.

Wide screen

List is wrapped, although space is available:

Image

Narrow screen

Image

This is a regression in readability compared to https://nodejs.org/docs/latest/api/deprecations.html which uses the available width at all times.

Image

Activity

  1. avivkeller commented on Jul 21, 2026

    @avivkeller
    Member

    I think this is an unavoidable consequence of the space we have available.

  2. MikeMcC399 commented on Jul 21, 2026

    @MikeMcC399
    ContributorAuthor

    I think this is an unavoidable consequence of the space we have available.

    It looks like there was a design decision to limit the display width of the ToC when the window is wide. As far as the monitor display is concerned, there is plenty of space available. I've marked this up to indicate unused space between the wrapped text and the scroll bar on the right.

    Image

    I suggest to reconsider if it needs to be this way, or if it could be improved.

  3. avivkeller commented on Jul 21, 2026

    @avivkeller
    Member

    Oh, I may have read through the issue too quickly 😅. I assumed that the sidebar was too narrow, not that the content itself is wrapping within it. Thank you! That's something we can fix!

  4. added theissue type on Jul 21, 2026
  5. avivkeller commented on Jul 21, 2026

    @avivkeller
    Member

    I'm guessing this is a styling issue in ui-components, cc @nodejs/nodejs-website

  6. transferred this issue fromnodejs/doc-kiton Jul 21, 2026
  7. moved this from 📋 Backlog to ✅ Done in Node.js Websiteon Aug 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions