Feedback: request for various minor style changes

[davidje13]

Enter your suggestions in details:

I've been poking around the new documentation for a little while and I'd like to request a couple of small quality-of-life improvements to the styling. I think these are all too small to be individual issues in their own right, so here's an amalgamation of all the styling stuff I've found:

• can the maximum page width be expanded a bit? 110rem seems to work well. The current 104rem feels rather squashed on a large display, especially compared to the unlimited size of the old docs. (and currently there is slightly more content space if the window is 1919 pixels than if it is wider)

  current:
  

  proposed:
  

• the right-hand side-bar makes the page a bit "busy". Removing the bold styling helps make it less visually intrusive (and also makes the text vs. code links more consistent):

  current:
  

  proposed:
  

• with the new busier page, I sometimes find myself getting "lost" among the headings (especially after following links, which leave a small margin at the top for the page header, but it does not appear, so a line of text from the previous section is visible). Adding a small amount of top margin to all headings seems to help a lot:

  current:
  

  proposed:
  

• the scrolling index on the left should have more bottom padding, so that the browser's link preview does not obscure the bottom element when scrolled fully to the bottom:

  

  (personally I like being able to over-scroll areas like this by quite some margin, but even an extra 20 pixels would be enough to avoid the obscuring)

• the "history" drop-downs (which I personally use quite a lot in the current documentation, because I support all supported versions of Node.js in my libraries, so need to know how old methods are / if they have changed) is very squashed. Doubling the width makes it much more readable:

  current:
  

  proposed:
  

  (there's also some minor inconsistency in the highlighting style of history items; links do not go white on hover, so the first item usually appears different compared to the others when hovering)

• it's tracked elsewhere, but a "real" light mode would be very welcome! (Feedback: Colour contrast used for function parameter type names is too harsh #940)

---

Lest this be taken as a purely negative review, there's also a lot I like about the new design. The new display for function parameters and return types is clearer at-a-glance, and the always-available table-of-contents is useful (in fact it might be nice to give it more space by default; personally I don't find any value in things like "reading time" and the other details above the ToC could perhaps be moved beneath it). For the most part the suggestions here are just about small increases to margins & sizes.