Improve installation page to simplify and direct users to installation method

Đang mở
  • Có gì không ổn?
#960 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 2 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
35/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Đình trệ
Lĩnh vực
documentation

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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

Ngôn ngữ chính
Makefile
Star
13
Fork
71
Merge trung bình
3 ngày 11 giờ
Pull request đã merge (30 ngày)
30

Chuẩn bị môi trường

  • Không có Dockerfile hay tệp Docker Compose
  • Có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của napari/docs

Tất cả issue của napari/docs

Issue tương tự

Thêm issue về Documentation

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.