Skip to content

Installation: List the newest distributions first

Michael Friedrich requested to merge installation/distribution-order into master

Why is this change being made?

During the UX group conversation, @sytses shared the installation page and the ordering.

I was trying to fix the raspberry distribution order, but my patch was not that complete as !45325 (merged). My "problem": I did not know how haml works and the website is built before minus 3 hours. Now that I have read the dev guide, I got a nice local environment on my Macbook

One thing I wanted to suggest for the installation page: Users who want to install GitLab, don't necessarily have a Linux distribution flavour, and they would just pick the first they read.

Until now this would be in this order:

  • Ubuntu 16, then 18
  • Debian 8 then 9 then 10
  • CentOS 6
  • CentOS 7
  • CentOS 8

After all, the first pick always would result in necessary system upgrades after a while.

Screenshot_2020-04-02_at_23.09.40

If we change the order and suggest the newest distributions, we'll help new users getting started more easily. Those who are bound to a specific distribution will have to search a bit longer anyways.

  • Ubuntu 18, then 16
  • Debian 10 then 9 then 8
  • CentOS 8
  • CentOS 7
  • CentOS 6

I'm coming from 10 years Icinga community support and documentation writing, my gut feeling is that "newest first" helps. Especially when e.g. CentOS 6 or Ubuntu 16 is EOL in a while, not many new users would need to go this route with long upgrades, as they already use CentOS 8 and Ubuntu 18.

Screenshot_2020-04-02_at_23.09.14

@sytses Assigning this to you and your shadows since this might need a second thought :)

cc @clenneville

Does this MR meet the acceptance criteria?

Assign to DRI

  • Did you assign this change to the correct DRI of the page or information you are changing?

Conformity

Merge request reports