概念示例像一张放大的阅读便签:它让某个关系更明显,却不负责呈现真实产品的全部情形。使用前,先看清“示意”两个字。
示例必须回答一个明确问题
比如想解释“如何把条件接在步骤前”,便可自拟一段概念文字:“若资料写明条件甲,再阅读步骤乙。”这只是句法示意,不是某个梯子游戏的条件甲或步骤乙。示例若没有明确要说明什么,读者容易把其中的任意细节都当成重点。
将设定和推论分开
用一栏写示例自带的前提,一栏写它演示的阅读动作。不要从演示结果反推未写出的规则。例如示例只有一条路径,不代表实际资料没有其他路径;示意图上的箭头也只说明这篇文章如何组织信息。
回到原始资料检验
示例可以帮你提出“具体资料是否也有这样的条件”的问题,但答案要在明确版本的原文里找。若真实资料不符,应放弃示例中的假设,而不是为了维护图形改写原文。引用别人的示例时,保留其“假设”或“例如”的标记。
使用边界
- 说明示例服务于哪个概念。
- 明确写出人为设定的前提。
- 不把示例的简化结果推广到产品。
用一个虚构句子试验示例边界
自拟“若文档先列条件甲,再进入步骤乙”的句子,只用来示范条件如何连接步骤。随后列出它没有提供的内容:甲究竟是什么、乙是否有例外、这是否来自任何真实版本。把这些未给信息写出来,示例的用途便会清晰。
再让另一位读者只看图注,看他是否能分辨这是概念演示而非产品截图。若不能,补上“示意”标记和一句范围说明。示例越像一份完整规则,越需要明确交代人为设定的前提。
画一个只含甲与乙的概念示例,再在图下写“甲、乙为阅读关系的代号”。随后问自己:如果把代号换成真实产品名称,图还能成立吗?没有核实的原文就无法回答。保留抽象性是有意的设计,它允许解释结构而不假装掌握具体规则。
阅读边注
本站所有示例图均为概念示意,不呈现实际界面、运营结果或官方规则。
继续核对
下一篇专门查看示例省略的条件;它们往往决定读者能否正确外推。