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

Make the getting started / installation page look nice again #10353

Closed
afbjorklund opened this issue Feb 3, 2021 · 4 comments · Fixed by #11399
Closed

Make the getting started / installation page look nice again #10353

afbjorklund opened this issue Feb 3, 2021 · 4 comments · Fixed by #11399
Assignees
Labels
good first issue Denotes an issue ready for a new contributor, according to the "help wanted" guidelines. help wanted Denotes an issue that needs help from a contributor. Must meet "help wanted" guidelines. kind/documentation Categorizes issue or PR as related to documentation. kind/ux priority/backlog Higher priority than priority/awaiting-more-evidence.

Comments

@afbjorklund
Copy link
Collaborator

afbjorklund commented Feb 3, 2021

After adding architectures to the "Installation" section, it's an even bigger mess than it was before...

Now it separates both on OS and on CPU, and it can be confusing to know what to actually download:

https://minikube.sigs.k8s.io/docs/start/

(1) Installation

  • Linux
    • x86
      • Binary download
      • Debian package
      • RPM package
    • ARM
      • Binary download
      • Debian package
      • RPM package
  • macOS
    • Brew package manager
    • x86
      • Binary download
    • ARM
      • Binary download
  • Windows
    • Windows Package Manager
    • Chocolatey
    • Stand-alone Windows Installer

Hopefully there is some nice web design that could be done, especially for the Linux tab ?

minikube-installation

I described three different workarounds (in text), but am looking for a better looking solution.

@afbjorklund afbjorklund added kind/ux kind/documentation Categorizes issue or PR as related to documentation. help wanted Denotes an issue that needs help from a contributor. Must meet "help wanted" guidelines. labels Feb 3, 2021
@afbjorklund
Copy link
Collaborator Author

afbjorklund commented Feb 3, 2021

There was also a long rant about the installation page and the evil of nested tabs, in #9066 (comment)

It would be great if the new solution could handle more than three options, like 5 or so: #9066 (comment)


Some examples of good "install pages" would be nice too.

So far we mostly have examples of the exact opposite...

Not that there is anything wrong with them, in content.

Just that they look scary, and scare away the "TL;DR"

@ilya-zuyev ilya-zuyev added the good first issue Denotes an issue ready for a new contributor, according to the "help wanted" guidelines. label Feb 3, 2021
@medyagh
Copy link
Member

medyagh commented Feb 3, 2021

anyone picking up this task, u could do a nested Tab in the installation page https://minikube.sigs.k8s.io/docs/start/

@sharifelgamal sharifelgamal added the priority/backlog Higher priority than priority/awaiting-more-evidence. label Feb 8, 2021
@t3hami t3hami removed their assignment Feb 22, 2021
@dinever
Copy link
Contributor

dinever commented May 9, 2021

Hi guys,

I did some quick prototype. What do we think about this style?

installation

This is inspired by CUDA: https://developer.nvidia.com/cuda-downloads

cuda

Another example is PyTorch: https://pytorch.org/get-started/locally/

I'm happy to work on it. Let me know if you think this is a good idea. Otherwise I can do nested tabs.

Thanks!

/assign

@afbjorklund
Copy link
Collaborator Author

@dinever : I like it! And I think that nested tabs are horrible.

Ultimately the computer should be able to find this out for itself, but until we are there I think this "mini-quiz" will work ?

It also has plenty of room for scalability, if we want to add the other three platforms in a more "dimmed out" manner...

minikube-1.20.0-0.aarch64.rpm
minikube-1.20.0-0.armv7hl.rpm
minikube-1.20.0-0.ppc64le.rpm
minikube-1.20.0-0.s390x.rpm
minikube-1.20.0-0.x86_64.rpm
minikube-darwin-amd64
minikube-darwin-amd64.tar.gz
minikube-darwin-arm64
minikube-installer.exe
minikube-linux-amd64
minikube-linux-amd64.tar.gz
minikube-linux-arm
minikube-linux-arm64
minikube-linux-ppc64le
minikube-linux-s390x
minikube-windows-amd64.exe
minikube-windows-amd64.tar.gz
minikube_1.20.0-0_amd64.deb
minikube_1.20.0-0_arm64.deb
minikube_1.20.0-0_armhf.deb
minikube_1.20.0-0_ppc64el.deb
minikube_1.20.0-0_s390x.deb

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
good first issue Denotes an issue ready for a new contributor, according to the "help wanted" guidelines. help wanted Denotes an issue that needs help from a contributor. Must meet "help wanted" guidelines. kind/documentation Categorizes issue or PR as related to documentation. kind/ux priority/backlog Higher priority than priority/awaiting-more-evidence.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

6 participants