Skip to content
代码片段 群组 项目
提交 d5125034 编辑于 作者: Amy Qualls's avatar Amy Qualls 提交者: Marcel Amirault
浏览文件

Create a Vale test for ease-of-use words

Words describing ease-of-use shouldn't appear in documentation.
While that statement may seem outrageous and odd from a Product
view, it's an empathy issue at heart. As technical writers, we're
aware that what's easy for an experienced user can be complex and
frustrating (dare I say "hard"?) for new users, and telling a user
a seemingly-impossible task is "easy" causes cognitive dissonance
and frustration.
上级 777e2d07
No related branches found
No related tags found
无相关合并请求
---
# Suggestion: gitlab.Simplicity
#
# Checks for words implying ease of use, to avoid cognitive dissonance for frustrated users.
#
# For a list of all options, see https://errata-ai.gitbook.io/vale/getting-started/styles
extends: existence
message: 'Avoid words like "%s" that imply ease of use, because the user may find this action hard.'
level: suggestion
ignorecase: true
link: https://docs.gitlab.com/ee/development/documentation/styleguide.html#language-to-avoid
tokens:
- easy
- easily
- handy
- simple
- simply
- useful
0% 加载中 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册