Update Bundled App Installation Instructions

[jaimergp]

Description

Add detailed installation instructions for the new conda-based bundled app, updated with screenshots from 0.5.0+.

References

Closes #67

This PR brings napari/napari#4383 over to napari/docs. It's not a perfect port, and I had to edit some patches, but it keeps most of the original history.

Inspired by napari/napari#5240 (comment), I followed these steps:

1. Obtain the commit-by-commit patch from the original PR:

$ cd ~/devel/napari/napari
$ gh pr checkout 4383
$ gh pr diff --patch > ~/tmp/napari-4383.patch

2. Apply patch interactively on napari/docs:

$ cd ~/devel/napari/docs
# Create new branch from up-to-date main
$ git checkout main
$ git pull upstream main
$ git checkout -b bring-napari-4383
# Apply patch
$ git am ~/tmp/napari-4383.patch

Sadly, the naive git am command with no flags didn't work, so I had to do it "interactively" with -i --rejected, which iteratively creates *.rej files with the rejected chunks of each patch:

$ git am -i --rejected ~/tmp/napari-4383.patch
# analyze rejection and modify target file; then:
$ git am -i --rejected --continue
# rinse and repeat til you are done

---

[jaimergp]

Loving the <kbd> default style!

[psobolewskiPhD]

Gentle reminder about this one @jaimergp Pretty high-value contribution!!
❤️

[jaimergp]

I don't remember what was blocking this, but I think I recall it was something about conveying the right kind of messaging in the website. Are we ok to publish this now? @psobolewskiPhD

Assuming we are, I think it would just need to update the screenshots so it shows 0.5.0 instead of 0.4.18-ish, and maybe polish some text here and there.

Are we still pushing images directly in the git repo or is there another mechanism I should be aware of?

[psobolewskiPhD]

@jaimergp I think the bundle was considered experimental? but now it's pretty stable, right?
Anyhow, I think it's definitely something we want in the docs.
Nothing has changed with images, just commit and push.

[melissawm]

Hi all! Is there anything I can do to help push this forward? Cheers! 😄

[jaimergp]

Now that we have 0.5.x out, we can take the screenshots and update the text.

[jaimergp]

@melissawm - do you happen to have a Linux (VM or not) machine for x64? I can only virtualize ARM 😬

[melissawm]

@jaimergp yes I do, happy to help!

[jaimergp]

Excellent, we'd just need to update the screenshots docs/tutorials/assets/tutorials/installation/bundle_{28..35}.png with the most recent Linux SH installer at https://github.com/napari/napari/releases/tag/v0.5.0.

[melissawm]

Instructions work fine on Manjaro - do you need anything else? Updated screenshots of the viewer? For the terminal screenshots, I think the Ubuntu ones are more common tbh.

EDIT: Got it, will push to this PR in a few mins.

[jaimergp]

Updated screenshots of the viewer?

It's mostly about the version string in the screenshots. Having 0.5.0 looks cleaner than a dev version of 0.4.17 😬

I need to update the text too. I'll take a look at your suggestion, thanks!

[melissawm]

Let me know if you need something different!

[jaimergp]

Looks amazing, thanks @melissawm!

[psobolewskiPhD]

This looks super!
Could we get it better integrated with the installation guide?
https://output.circle-artifacts.com/output/job/a8a5e740-214a-47ab-9c56-fed5228432a4/artifacts/0/docs/docs/_build/html/tutorials/fundamentals/installation.html#install-as-a-bundled-app
I think this should be all but dropped and just replaced with a link to the new guide?

[jni]

@jaimergp we just discussed this at community meeting. At a minimum before merge we would like to add a link to this new guide in this page (source link). We are planning to release later today, so if you have a chance to add a small link 🙏 that would be great, otherwise, let us know and we can push directly.

[jaimergp]

How does this look: https://output.circle-artifacts.com/output/job/fb66cbb2-7b72-4b9e-9aa2-4199b5844109/artifacts/0/docs/docs/_build/html/tutorials/fundamentals/installation.html#install-as-a-bundled-app

[jni]

it looks good to me, thanks @jaimergp — I'm just gonna give @psobolewskiPhD a chance to have another look at it, but will just merge in the morning if he doesn't get a chance.

comments were address by adding link in b322829

[psobolewskiPhD]

Sorry I dropped the ball on this -- long day 😞

[jni]

all is well @psobolewskiPhD, I just hope I didn't offend you with

😂 🙏