Improve installation page to simplify and direct users to installation method

Aperta
#960 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 2 giorni

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
35/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Ambito
documentation

Direzione di ricerca

The issue discusses the installation page but does not name its file or tests. Find the page that presents the Python and bundle/app installation routes, then read its surrounding navigation and content. Update the page to make Python the primary route and the bundle/app a clear alternative; done when users can tell which route is recommended.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

content

I mean that to very few people reading this page are the two options of equal value.
So to me it makes more sense to be opinionated and pick one route -- the Python one right now -- and then provide the other route -- the bundle/app right now -- as the clear alternative.

Having two tiles like that makes sense on the homepage or in on a quick-start page or some other page where other content will continue (so the tiles are the "go install, here's two options, come back when done"). But this is already the installation page that the user actively selected, so I think having a tile that does nothing is just weird. In general I think sometimes we try to present too many options at once, each as equivalent, rather than a clear main way, with perhaps an alternative.

(I love the admonitions because I love color. In Caldeum color means wealth!)

Originally posted by @psobolewskiPhD in https://github.com/napari/docs/issues/958#issuecomment-4087454247

Lingua principale
Makefile
Stelle
13
Fork
71
Merge medio
3g 8h
PR unite (30g)
31

Preparare l'ambiente

  • Nessun Dockerfile né file Docker Compose
  • Ha un modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di napari/docs

Tutte le issue di napari/docs

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.