GLOSSARY.md 格式
GLOSSARY.md是此教学工作区的规范语言。所有讲解、练习和学习记录都应遵循其术语。构建它本身就是学习的一部分:把一个概念压缩成精确定义,正是用户理解它的证据。
结构
# {主题} 术语表 {一两句话描述此术语表涵盖的主题。} ## 术语 **肥厚(Hypertrophy)**: 由反复训练中的机械张力和代谢压力驱动的肌肉生长。 _避免使用_:增肌、变大 **渐进超负荷(Progressive overload)**: 随时间系统性地增加对肌肉的需求——通过负荷、容量或强度。 _避免使用_:更用力、升级 **RPE(主观疲劳程度)**: 对一组动作感觉有多难的 1-10 分自评,其中 10 表示力竭,8 表示还剩两次重复。 _避免使用_:用力评分、强度评级规则
- 只有在用户理解某个术语时才添加它。术语表是压缩知识的记录,不是用户阅读学习的字典。如果用户刚接触一个概念,等到他们能正确使用后再提升到这里。
- 要有主见。当同一个概念有多个词时,选择最好的一个,并把其余的列为要避免的别名。这就是语言压缩的方式。
- 保持定义精炼。一两句话。定义这个术语_是什么_,而不是它做什么或怎么做。
- 在定义内部使用术语表自己的术语。一旦某个术语进入术语表,在任何地方都优先使用它——包括在其他定义内部。这就是让复杂术语以后更容易理解的原因。
- 当自然聚类出现时按子标题分组(例如
## 解剖学、## 编程)。术语相互关联时,扁平列表也可以。 - 明确标记歧义。如果某个术语在更广泛的领域中被松散使用,记录解决方法:“在此工作区中,'组’始终指正式组——热身组单独跟踪。”
- 随着理解的加深进行修订。用户第一周写的定义到第六周可能就错了。就地更新;不要留下过时条目。