Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Redesign the Downloads page tabs to reflect on latest agreements with Package Maintenance WG #7037

Open
ovflowd opened this issue Sep 12, 2024 · 14 comments
Labels
accessibility Issues concerning accessibility content Issues/pr concerning content design enhancement help wanted i18n Issues/PRs related to the Website Internationalisation ideas website redesign Issue/PR part of the Node.js Website Redesign

Comments

@ovflowd
Copy link
Member

ovflowd commented Sep 12, 2024

The Issue

After the initial redesign of https://nodejs.org, the Downloads page became much cleaner and easier for newcomers and experienced devs to find the method they desired for downloading Node.js.

Although successful, the page structure currently implies a few problems:

  • The Package Managers tab mixes Node.js version managers and OS's/App package managers, which also distribute Node.js
  • Unofficial and other ways of downloading Node.js are buried within the "Prebuilt Binaries" tab
  • No easy way to access a direct link for a Changelog of a given release
  • Due to how we recommend Package managers and Node version managers, we cannot add more version managers and other options of package managers maintained by the community.

This issue proposes a UX update that addresses all these problems.

The Solution

Re-arrange/rename tabs and their contents:

I propose a new set of tabs that will respectively contain the following download options:

  • Node.js version managers (RECOMMENDED)
  • OS package managers
  • Prebuilt Binaries
  • Other ways

Each one of these tabs will also have a tooltip that renders when users hover said tab headers with the following respective text:

Node.js version managers (RECOMMENDED)

It automatically manages Node.js versions within your system using Node.js-specific version managers such as nvm, fnm, and others.

OS package managers

To install Node.js on your system, use your favorite OS/distribution's built-in or third-party package manager, such as apt, brew, or chocolatey.

Prebuilt Binaries

Download fully self-contained and extractable archives containing binaries of Node.js. Great for portable installations.

Other ways

Find other ways of installing Node.js, such as downloading its source code, unofficial builds, and more.


Note that these are just example tooltips prone to being updated and proofread; they should also be translatable.

Move source code and unofficial/other installation methods to "Other ways"

This allows us to easily aggregate the alternative ways of downloading Node.js without obscuring them on the small text below the "Source code" and "Prebuilt Binaries" tabs.

The new Package Manager and Version Manager tabs should be restructured

Within these CodeTabs, you'll be asked for the desired Node.js version, OS, and Architecture (and maybe OS version (?))

The final dropdown box will render options based on these choices, but the main difference is that now we will have options within said Dropdown grouped by "Official" and "Community" options.

The official options are either package managers or version managers sanctioned by the Package Maintenance WG -- and known to always be up to date, regularly maintained, and following best practices. Said best practices and criteria to be defined by @nodejs/package-maintenance; For example, nvm and brew fit this criterion because they follow Node.js versioning standards and LTS standards.

Other options, such as apt, nuget, etc., will be under "Community" options because they aren't always up to date, are based on the OS/distro version, or use different versioning formats.

And then adding a little copy-text on the bottom making the distinction of "Official/Recommended" vs. "Community" -- this distinction is safe enough and the separation for us to allow people to send PRs for adding numerous different package managers and version managers around the clock.

By doing this, we can eventually get rid of the "All package managers" page that is very hard to find.

Changelog Button

When clicked, the changelog button should be an a. It opens the modal (onClick), but all other bindings, like right click and cmd+click, should bind to the default a handlers. People can copy the URLs or open the raw Changelog MD file on GitHub.


These are the numerous changes I'm proposing in order to future-proof and make the current Download pages even friendlier and easier to use.

@ovflowd ovflowd moved this to 📋 Backlog in Website Redesign Sep 12, 2024
@ovflowd ovflowd added enhancement accessibility Issues concerning accessibility content Issues/pr concerning content design i18n Issues/PRs related to the Website Internationalisation ideas website redesign Issue/PR part of the Node.js Website Redesign help wanted labels Sep 12, 2024
@AugustinMauroy
Copy link
Member

I suggest that we change the icon for the links because I don't think the meaning is right.
We should put the ‘Link’ icon in place of arrow

Capture d’écran 2024-09-12 à 18 33 46

Capture d’écran 2024-09-12 à 18 33 31

@mhdawson
Copy link
Member

+1 on the suggestion overall.

@cinderblock

This comment was marked as off-topic.

@ljharb

This comment was marked as off-topic.

@ovflowd

This comment was marked as off-topic.

@ovflowd

This comment was marked as off-topic.

@cinderblock

This comment was marked as off-topic.

@ovflowd

This comment was marked as off-topic.

@rxmarbles
Copy link
Contributor

Same +1 to the suggestion overall

@ovflowd
Copy link
Member Author

ovflowd commented Sep 30, 2024

FYI I aim to lead the development on this, but I need to have a final +1 from @nodejs/package-maintenance 🙏

@ovflowd
Copy link
Member Author

ovflowd commented Nov 20, 2024

Bumping this @nodejs/nodejs-website; unfortunately, I overestimated my availability here. Would anyone volunteer to lead this work? I can sync regarding the overall idea/UX that this should have ✨

@AugustinMauroy
Copy link
Member

It reminded me that at the Collab summit @targos had mentioned that on the prebuilt-binairies page it would be interesting to have a codebox with the links for copying and pasting. Because most of the time people who install bianaries do so to use them on a server that they access with SSH.

Michaël could you confirm that was you point of view ?

https://nodejs.org/en/download/prebuilt-binaries

@mhdawson
Copy link
Member

A different Michael here, but in terms of using the pre-built binaries my 2 cents is that is what I do all the time. I copy he URL and then use wget to pull down the binary.

@AugustinMauroy
Copy link
Member

Can I try to get started on this? If nobody's put their hand in the pudding.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
accessibility Issues concerning accessibility content Issues/pr concerning content design enhancement help wanted i18n Issues/PRs related to the Website Internationalisation ideas website redesign Issue/PR part of the Node.js Website Redesign
Projects
Status: 📋 Backlog
Development

No branches or pull requests

6 participants