Linux Installation Path Setup and distro tabs

yarnpkg / website

Yarn package manager website

https://classic.yarnpkg.com

431 stars 974 forks source link

Linux Installation Path Setup and distro tabs #786

Open jthegedus opened 6 years ago

jthegedus commented 6 years ago

It is not :100: clear on the Linux tab of the Installation page that there are important instructions below the details of each Distro.

Most people will be using the top 2-3 distros listed and will run the appropriate commands and then move on without scrolling to the end of the page, there is no indication that a critical installation step is at the end of the page.

A few suggested solutions:

have a navigation guide for the headings on the page (or add the page's headings below the page link in the right-hand nav guide)
move all distros to tabs within the Linux tab. This way only one distro is shown and the following headings are not seen as unimportant to the user.

I've seen a number of discussions now where people have missed the Path Setup section because they have not scrolled (myself included), re: https://github.com/yarnpkg/yarn/issues/648#issuecomment-370142902

Daniel15 commented 6 years ago

I started working on this in #592 but never finished it. Would you like to take a look and try to rebase it?

jthegedus commented 6 years ago

I will indeed give that a look. I was hesitant to start an issue since this is so trivial, but am glad I did as I didn't see the existing work. This will save me some time :smiley: I should have time to update the PR within the fortnight, cheers.

jthegedus commented 6 years ago

Completed in #592 :smile:

jthegedus commented 6 years ago

I spoke too soon. It seems the Path Setup section from the Alternatives section should appear as a Post install step on all *nix OS selections (or at least the Ubuntu one).

The main criticism previously was that this step is generally required by most but was hidden. Being under a different Install option/selection does not address bubbling this up.

Two suggested solutions:

copy the nix section from the Alternatives selection to each of the nix selections.
add a red warning & link at the end of each of the *nix sections to point to the Alternatives section.

The first is preferred IMO.

Daniel15 commented 6 years ago

Oh, good point. Feel free to submit a pull request for this, otherwise I may do it at some point. 👍

jthegedus commented 6 years ago

What would be the preferred option? Duplicating or a strongly worded & highlighted redirect?

Daniel15 commented 6 years ago

Duplicating is fine. We already show the path stuff for RC and nightly releases for some Linux distros where you need to use the installer rather than the package (eg. select CentOS nightly on the download page), we could instead just show that all the time.

-- Regards, Daniel Lo Nigro https://dan.cx/ | Twitter http://twitter.com/Daniel15 | Facebook http://www.facebook.com/daaniel

On Mon, Apr 30, 2018 at 9:12 PM, James Hegedus notifications@github.com wrote:

What would be the preferred option? Duplicating or a strongly worded & highlighted redirect?

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/yarnpkg/website/issues/786#issuecomment-385369458, or mute the thread https://github.com/notifications/unsubscribe-auth/AAFnHYA3pd9VlusXkFVyyinjogx7-nlWks5ttvGogaJpZM4Sa58g .