Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Background section is a mess

Đang mở
#84 2 bình luận 0 reaction 0 người được giao Xem trên GitHub

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
45/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Đình trệ
Lĩnh vực
documentation

Hướng nghiên cứu

Open the linked Background section in the current editors draft and compare its wording with W3C recommendation style. Rewrite or remove the first-person, browser/version references, forum discussion details, and excessive background material; done means the section no longer reads like a blog post.

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

Mô tả

Editorial

The background section of the current editors draft does not follow the language of standards, or the tradition of W3C recommendations. One can easily point to a number of breaches of style:

  • Writing in first person ("So I changed the spec...").
  • Referring to specific browsers (even specific versions). It's called "user agent" for a reason.
  • Referring to specific forum discussions (using a broken link, by the way).
  • Going into details in a what is supposed to be a background section.

In short, the current text reads like a blog post and has no place in a standards document. It should be removed or completely rewritten.

Ngôn ngữ chính
HTML
Star
49
Fork
30
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

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

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 w3c/selection-api

Tất cả issue của w3c/selection-api

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.