Make text on the website friendlier and less off-putting
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 新手友好度
- 45/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
- 领域
- content, documentation
调研方向
在网站源代码中搜索位于 /、/whitepaper/ 和 /guidelines-for-respectful-communication/ 的页面，并定位引用的文本。审查拟议的措辞和 URL 更改，包括可能移除对 Stallman 的引用。相关页面上出现约定的语言，并且指向重命名页面的链接能够正常工作，即表示完成。
由索引模型根据 Issue 内容生成。
描述
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
- 主要语言
- CSS
- 星标
- 44
- 派生
- 53
- 平均合并
- 1 天 9 小时
- 30 天内合并 PR
- 7
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
haskellfoundation/haskellfoundation.github.io 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 65/100
haskellfoundation/haskellfoundation.github.io#623 · 1 个 reaction ·
维护者通常 1 天内回复
-
The Technical Working Group doesn't seem to be mentioned anywhere on the website!可能重新可做 @LaurentRDC 于 274 天前认领，目前没有进行中的 PR。 未关闭Important
haskellfoundation/haskellfoundation.github.io#569 · 已指派 1 人 ·
维护者通常 1 天内回复
-
Make GfRC retargetable可能已有人在做 关联的 PR 仍在进行中或已合并。 未关闭
难度 5/5 一周以上 新手友好度 25/100
haskellfoundation/haskellfoundation.github.io#505 · 7 条评论 · 3 个 reaction ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 50/100
haskellfoundation/haskellfoundation.github.io#436 · 1 条评论 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 55/100
haskellfoundation/haskellfoundation.github.io#400 · 1 条评论 · 2 个 reaction ·
维护者通常 1 天内回复
查看 haskellfoundation/haskellfoundation.github.io 的全部 Issue
相似的 Issue
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
难度 1/5 1 小时以内 新手友好度 78/100
lingdojo/kana-dojo#32505 · 1 条评论 · 5 个 reaction ·
维护者通常 1 天内回复
-
area: reader bug status: needs-triage
难度 2/5 1-3 小时 新手友好度 72/100
amatya-aditya/obsidian-rss-dashboard#1190 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 62/100
IQSS/dataverse.org#95 ·
-
Bug: Minor Status: Triage
难度 2/5 1-3 小时 新手友好度 62/100
GTNewHorizons/GT-New-Horizons-Modpack#27274 ·
维护者通常 1 天内回复
-
content good first issue
难度 1/5 1 小时以内 新手友好度 78/100