Version indicator for rendered examples
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 35/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Đình trệ
- Công nghệ
- react
- Lĩnh vực
- documentation
Hướng nghiên cứu
Bắt đầu bằng cách so sánh các URL ví dụ được liên kết của Date Time Picker Lit, React và Flow với ví dụ được nhúng, bộ chọn Show code và hành động Open in a new tab. Hoàn tất khi người dùng có thể xác định phiên bản được kết xuất trong các ví dụ được nhúng và được mở, hiểu khi nào phiên bản đó khác với lựa chọn của họ và thấy những phiên bản nào hiện có.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
#4400 changed the Docs to always render the React example if available, regardless of the selected source code type. This causes some issues.
- Currently it isn't indicated to the users in any way that the rendered example doesn't match the source code selection.
- You can still view e.g. the Flow example by clicking the "Open in a new tab" button at the corner when you have Flow selected for displaying the source code, but it likewise isn't indicated in any way that this is necessary, or that it possibly opens something else than what you already see.
- If you do open to a new tab, what you see there doesn't indicate which version it belongs to either, or whether it matches what you saw in the embedded version. You can't easily decipher this from the new URL either.
- You can't even see the version selection without first clicking 'Show code', so you might be initially looking at an embedded React example and accidentally open a Lit example to a new tab when you are actually trying to check out how the feature behaves in Flow.
- Presumably if one of these versions didn't exist at all, it would open some other version in the new tab without the user being none the wiser.
E.g. the first example about Date Time Picker component currently links to these pages: Lit, React, Flow
The Lit URL above doesn't even mention Lit, and the Flow URL doesn't mention Flow but it does mention React even if it's apparently still the Flow example in reality.
Obviously none of this is very ideal and it's confusing to users and staff members both.
-
It would be nice to have some small indicator in the embedded example already on what version is rendered there -- if I understood correctly it's not even always React, it might still be Lit or Flow of there is no React version available. This indicator could be e.g. an icon or a letter.
- Bonus points if there would be an info button or a tooltip or something else that explains what the indicator means -- and, if that's indeed the case, why the displayed version doesn't match the selected version in the code examples. If this explanation is very long, it could link to some FAQ instead.
-
It would also be nice to have some small indicator in the opened tab on which version was actually opened there.
- Bonus points if the indicator could be clickable to expand a version list that would indicate which other versions are actually available and redirect you there upon selection.
If you think this issue is important, add a 👍 reaction to help the community and maintainers prioritize this issue.
- Ngôn ngữ chính
- AsciiDoc
- Star
- 38
- Fork
- 225
- Merge trung bình
- 17 giờ 38 phút
- Pull request đã merge (30 ngày)
- 214
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
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- 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.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của vaadin/docs
-
Creating Tests page uses deprecated TestBench ElementQuery APICó thể đã có người làm @jcgueriaud1 đã nhận 5 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 83/100
Maintainer thường phản hồi trong vòng 1 ngày
-
design system
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
vaadin/docs#5773 · 1 reaction ·
Maintainer thường phản hồi trong vòng 1 ngày
-
design system
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 72/100
Maintainer thường phản hồi trong vòng 1 ngày
-
a11y design system
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
Maintainer thường phản hồi trong vòng 1 ngày
-
a11y design system
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
Maintainer thường phản hồi trong vòng 1 ngày
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
OneBusAway/maglev#2145 ·
Maintainer thường phản hồi trong vòng 2 ngày
-
ada documentation mobile report
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 86/100
physicsdolphin/nv-uefi-unlocker#254 · 2 reaction ·
Maintainer thường phản hồi trong vòng 1 ngày
-
devops help wanted
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
guaardvark/guaardvark#421 ·
Maintainer thường phản hồi trong vòng 2 ngày
-
marketing
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Add SECURITY.mdĐang mởenhancement
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 65/100
Maintainer thường phản hồi trong vòng 1 ngày