Skip to content

Priority levels are confusing 优先级令人费解 #32

@YDX-2147483647

Description

@YDX-2147483647

2025-07-10 有多人反馈看不懂优先级,表格和颜色都不太理解。

不理解之处

表1没看懂

常见和专业是什么
专业有歧义,不一定理解成“不常见”

完全没看懂

为啥常见和不常见的标度不一样

难度和优先级confuse了

颜色是什么意思

辅助开发者判断修复优先级,还是主要给用户这边看?

之前设计目的

放这张表的目的是解释ok、advanced等级别的标准,并强调级别并不描述问题坏的程度,而是描述一般人受影响的程度。具体来说,问题越常见,解决难度越大,则级别越偏红;解决难度相同,但问题不太常见的,级别就稍偏绿。

https://www.w3.org/TR/clreq-gap/ 的图例我当时看了好半天才明白,所以没照抄;没想到改完了还是不太行……

(就是“常见”和“不常见”,写“专业”是凑字数)

不是描述问题坏的程度,而是描述影响程度。
对于特化功能来说,配置一下是 expected
就是越往下问题越大

解决问题的优先级

(ok、advanced、basic是W3C发明的)

但实际上分不开两个维度,只能混一起标。
通常是因为解决办法不唯一。简单办法可能让大部分人看不出来,把常见需求将成专业需求;而别的办法能让更多人满意,可未必简单可靠。这种情况是还是🤮呢?
比如旧版typst中西设置不同字体有两种办法:简单的(西文字体, 中文字体)引号宽度不对,困难的show regex set连续标点不对。能显出第二种不对的文段更少,能看出第二种不对的人更少。

可能解决办法

severity放明度,difficulty放色度,标准化打分

常规和特化功能

让他正交是对的 但是这几个维度不一定对

比如其实还有形状能用 形状已经被占了,圆的表示手动标的级别,方的表示从多个问题综合计算出的级别。

解决相应问题/达成相应排版要求所花费的时间/精力在所有已入门用户里的分布的下限()和均值(🟠🟡🟢)
下限表示可用性,应该想办法向typst贡献解决,均值表示难易程度,应该可以通过整理相关解决方法的教程改善

罕见程度、解决难度,严重性 = f(罕见程度, 解决难度)

对排版的影响

解决难度减去罕见程度

其实应该是需求到罕见程度和需求到严重性,但我觉得把需求列出来了这个就可以暂时不考虑?

至于包不包含严重性信息我觉得不是首要的,因为主要是给用户这边看的?

尚无一致认同更好且当前可行的办法,故暂且保持不变。

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions