Review the text layout design
Whilst I think the new layout of the site is much cleaner, and much easier to read & follow content, I do think there should be a review of the approach to using so much 'white space' either side of the content.
For example, I am using the new site, to review a document on my PC. I have the browser window snapped to one side, whilst I walk through the actual settings on another window (snapped to the other half of my screen).
The 'docs' content - on the left hand side - is now limited to two-thirds of the browser window.
A third of that browser page space, on the left hand side, is lost automatically to a menu that is only visible at the top of the page. It's not until you slide the side of the window (inward) to make the broswer page narrower, does the 'white space' dissapear. It's not an intuitive thing to do.
The design might work best where you're using a smaller resolution, but where you have resolution such as 1920x1080, you have the content you want to read in a small part of the screen space.
Is there an option to scale the page sizing based on native resolution ?
Users with high resolution screens (https://msdocs.uservoice.com/forums/364242-general-site-feedback/suggestions/13767834-review-the-text-layout-design) also will benefit with ability to use full screen for content
Currently side columns on docs pages have fixed width and on iPad they are too wide. They force the middle context column to be too narrow, do not use full real estate, and, in particular for code examples, I have to scroll it right and left all the time to read the text.
It will be better to allow user to collapse left and right columns and expand them only when needed
Can you please clarify what specific parts of the VSCode site you'd like to see implemented on docs?
James Urry commented
Though the scope is much narrower the speed and clarity of the layout and design really is excellent.
While the layout of articles looks nice typographically, it wastes too much otherwise valuable screen space.
Heading have massive white space above and below and are in my opinion larger font sizes than they need to be.
Increase the information density - by not wasting the space available. I don't want to have to keep scrolling to see little bits of a topic.
James Urry commented
The colours and lines in the site are extremely pale and are very low contrast. It makes identifying sections and general navigation to be less intuitive than it could be.
The set content width may be easier to read but it makes the text look awfully lonely sitting in the middle of the page with huge amounts of white space on either side. I had to check whether I'd turned off images because it's so unusual to have nothing at all in the left or right columns.
I suggest adding some faint shading on either side, leaving the background colour for the text column as white, to indicate it's not a mistake that all that empty space is there.