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

Make text on the website friendlier and less off-putting

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

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

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
45/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
content, documentation

Hướng nghiên cứu

Tìm kiếm trong mã nguồn của website các trang tại /, /whitepaper/ và /guidelines-for-respectful-communication/ rồi xác định đoạn văn bản được trích dẫn. Xem xét các thay đổi được đề xuất đối với cách diễn đạt và URL, bao gồm khả năng xóa tham chiếu đến Stallman. Công việc được xem là hoàn tất khi ngôn ngữ đã thống nhất xuất hiện trên các trang liên quan và các liên kết đến trang được đổi tên hoạt động.

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

Mô tả

Duplicating an issue from the previous version of website about difficult and unfriendly language by presenting highlighted by @sjakobi changes in a more structured format and incorporating changes by @simonpj and @goldfirere.

Additionally adding a few more suggestions on my own.

Note: The previous website repo was archived but issues weren't transferred to the new one. I care about this particular issue but I don't have the capacity or motivation to transfer the remaining issues.

The main motivation is the the website is difficult to read for non-native English speakers and it sounds unnecessary convoluted or even hostile in many places. This implicitly sends the message "You're not welcome in Haskell if you're not smart enough".

Where: https://haskell.foundation/
Old: Our Ethos
New: Our Values
Motivation: The word "ethos" itself is rather unclear. It's not a common choice of words for naming this section so the language sounds alien.

Where: https://haskell.foundation/
Old: Haskell’s design puts principle ahead of expediency by cleaving closely to the principles of purely functional programming.
New: Haskell's design puts principle ahead of what is easy or popular by being firmly guided by the principles of purely functional programming.
Motivation: The word "expediency" is rather uncommon as well the expression "to cleave closely to sth.".

Where: https://haskell.foundation/
Old: HF augments, celebrates, and coordinates the contributions and leadership of Haskell’s vibrant community.
New: HF sees itself as a means to celebrate, coordinate, and make more powerful and effective, the contributions and leadership of Haskell’s vibrant community.
Motivation: The word "augment" as a verb is a rather obscure word.

Where: https://haskell.foundation/
Old: Haskell embodies a radical and elegant attack on the entire enterprise of writing software.
New: Haskell embodies an innovative and elegant approach on the entire enterprise of writing software.
Motivation: The word "attack" is too hostile and off-putting. I don't want to be associated with the language that "attacks" others. We change the wording here to a friendlier version.

Where: https://haskell.foundation/whitepaper/
Old: https://haskell.foundation/whitepaper/
New: https://haskell.foundation/mission-statement/
Motivation: The word "whitepaper" sounds too academic. It gives an impression of some academic research. It may look really weird that formulating a mission and reasons behind an organisation requires scientific research.

Side note: I wasn't able to find a link that directs to whitepaper from any of the pages on the main website. Maybe I just missed it but in any case is a bit odd to have a resource on the website not linked from anywhere. It gives the impression that it's not supposed to be found.

Where: https://haskell.foundation/guidelines-for-respectful-communication/
Old: The GNU Kind Communication Guidelines, published in October 2018, also express the positive tone we seek; Stallman’s post explains the intent.
New:
Motivation: Richard Stallman is a controversial figure. Despite their outstanding technical contributions, their views are not aligned with Diversity and Inclusion in tech. Keeping reference to Stallman's statements in the official guidelines to respectful communication simply stops almost everyone who associates themselves as minority in tech from joining the Haskell community or at least affiliating with HF. So I propose to remove the reference to their statements from Guidelines for Respectful Communication

Ngôn ngữ chính
CSS
Star
43
Fork
53
Merge trung bình
1 ngày 13 giờ
Pull request đã merge (30 ngày)
4

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 haskellfoundation/haskellfoundation.github.io

Tất cả issue của haskellfoundation/haskellfoundation.github.io

Issue tương tự

Thêm issue về Content

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.