install: reorder methods and add badges

[casperdcl]

LATEST UPDATE: Scroll to #7495 (comment).

Update options including order and badges.

• conda or
• snap or
  • also or
• pip
• GitHub donwloads
  • deb
  • pkg
  • rpm
  • exe
• apt (?)
• choco
• brew
• anything else?

Probably need to split first based on OS:

• Linux
  • conda
  • snap
  • deb/rpm
  • pip
• Mac
  • conda
  • brew
  • pip
  • pkg
• Windows
  • conda
  • choco
  • pip
  • exe

[jorgeorpinel]

Sounds like it's mostly about Windows @casperdcl. Would you like to open a PR directly for this? I think you worked on the snap method, for example.

[casperdcl]

I didn't intend it to be only about Win. In my experience there tends to be different ordering & options for Linux/Win/Mac. Could make a PR but probably needs discussion first from users of different OSs how they prefer/recommend installing (was discussing with @shcheklein...)

[shcheklein]

something else include "binary" pyinstaller packages - pkg on Mac, exe on Windows.

I think we can do something like:

Linux:

conda
snap
apt
pip

Mac:

conda
brew
pip
pkg

Windows:

conda
choco
pip
exe

@casperdcl I'm not sure about conda vs brew/snap, for example. How common is it to install things with conda globally? (I know for example it's better not to do this with pip).

[jorgeorpinel]

probably needs discussion first

It may be worth it to review past issues related to this, as we recently completely rewrote the installation section. e.g. iterative/dvc.org#701/#734, iterative/dvc.org#660/#701/#734, iterative/dvc.org#656/#695, others?

else include "binary" pyinstaller packages

Related: iterative/dvc.org#65 (That's an old one!)

[casperdcl]

I think there are 2 major categories to split up: OS and end-user proficiency. Casual users can't be expected to go through the lengthy "separate conda env with dvc script appended to global $PATH" I posted elsewhere. Actually I'd say casual users should stick to snap/choco/brew. Advanced users meanwhile probably don't need much guidance - they just need to be aware what packages exist.

[shcheklein]

@casperdcl sounds good.

Advanced users meanwhile probably don't need much guidance

It seems an obvious though, but my recent experience makes me think differently a bit. And probably, the reason for this that being even an advanced CLI user does not make you immediately an expert in different ways to install things or different environments.

Probably they do not fit then into your meaning of advanced though, right? :) and should stick with some default choice.

[casperdcl]

Probably they do not fit then into your meaning of advanced though, right? :) and should stick with some default choice.

Indeed. In this context I was using "advanced" to refer to knowledge of their preferred installation mechanism.

[jorgeorpinel]

Shall we include snap here too and close iterative/dvc.org#918? Cc @casperdcl please notice that other issue's desc:

as we discussed, could you please add this method to the docs as snap is official now?

[casperdcl]

for the record this issue is about documenting a new option reordering options while iterative/dvc.org#918 is about reordering options documenting a new option (vis iterative/dvc.org#918 (comment)).

[jorgeorpinel]

I think you meant this one is about reordering and iterative/dvc.org#918 about a new option @casperdcl.

[fabiosantoscode]

Don't forget brew works on linux!

[casperdcl]

also potentially badges (vis iterative/dvc.org#918 (comment)). Added to description here...

[jorgeorpinel]

Windows:
conda
choco
pip
exe

Why is conda on top? choco is probably the easiest from cmd line for most cases, no?

[shcheklein]

@jorgeorpinel it's a good question. I don't know how popular choco is to be honest ... it's as popular as brew for example?

[casperdcl]

I think maybe conda was on top for consistency across all platforms but I agree we should probably change to conda as second for all.

[jorgeorpinel]

it's as popular as brew

My impression is that it's the equivalent to brew, yes. But much fewer people work on command line in Windows just because (developers mainly, I guess, same as in Mac but there's less).

Probably more people use Anaconda Prompt because it's such a popular DS Python disto. But then again Git Bash is probably also quite popular (comes included in a bunch of other tools like Cmder or Git for Windows), and choco would be a better fit in those cases... so yeah not sure.

For now I put choco on top in iterative/dvc.org#1195

[jorgeorpinel]

I believe we did take care of this from seeing https://dvc.org/doc/install

[jorgeorpinel]

p.s. well except for the badges but do we want those in docs? Maybe in the README

[jorgeorpinel]

p.p.s. and the badges do exist in the README now. But the order there is not the same as in docs. Do you think we should reopen this and move it to the core repo @casperdcl ?

[casperdcl]

probably could be moved to core - would be a first iteration on updating somewhat neglected readmes.

https://github.com/iterative/terraform-provider-iterative/#readme just got an overhaul (iterative/terraform-provider-iterative#433) for reference/review :)

[efiop]

closing as stale