Improve installation page to simplify and direct users to installation method

Abierto
#960 1 comentario 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 2 días

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
35/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Estancado

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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

Lenguaje dominante
Makefile
Estrellas
13
Forks
71
Merge medio
3 d 11 h
PR fusionados (30 d)
30

Preparar el entorno

  • Sin Dockerfile ni archivo de Docker Compose
  • Tiene una plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de napari/docs

Todos los issues de napari/docs

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.