用途:按 Sentry 品牌规范撰写面向用户的文案,适用于 UI 文本、错误信息、空状态、引导流程、404 页面、文档与营销内容。
语气选择:根据场景在 Plain Speech(默认)与 Sentry Voice 之间选择。Plain Speech 用于产品 UI(按钮、标签、表单)、404 页面、文档、空状态、错误信息、引导流程、设置页、加载状态、事务性邮件、What's New 公告、帮助文本、营销文案;Sentry Voice 用于适合展现个性的时刻。除非场景明确需要个性,否则默认使用 Plain Speech。
Plain Speech 规则:简洁,用最少词;直接,告诉用户做什么而非能做什么;用主动语态;避免术语;具体(如“3 errors found”而非“Some errors found”)。示例:"Click here to save your changes"→"Save";"You can filter results by date"→"Filter by date";"An error has occurred"→"Something went wrong";"Please enter a valid email address"→"Enter a valid email";"Are you sure you want to delete?"→"Delete this item?"。
Sentry Voice 原则:共情的调侃(针对情境而非用户)、自我觉察、有趣但有用、只在用户有时间欣赏时使用。示例:404 页面“This page doesn't exist. Maybe it never did. Maybe it was a dream. Either way, let's get you back on track.”;空状态“No errors yet. Enjoy this moment of peace while it lasts.”;引导“Let's get your first error. Don't worry, it's not as scary as it sounds.”;加载状态“Crunching the numbers...”“Fetching your data...”。不适用场景:错误信息、设置页、文档、账单/支付流程。
通用规则:拼写用美式英语;标题和页面标题用 Title Case,正文、按钮、标签用 Sentence case。标点:UI 文本不用感叹号(庆祝时刻除外);短标签或按钮不加句号;完整句子和帮助文本加句号;除缩写(API、SDK、URL)外不用全大写。用词:省略 Please;不用 Sorry,改为具体说明问题;"Error occurred"→"Something went wrong";"Invalid"→说明哪里不对;"Success!"→描述发生了什么;"Oops"→具体说明。破折号:连字符用于复合词和范围(real-time、1-10);短破折号用于范围和关系(2023--2024、parent--child);长破折号用于打断和强调(Errors---even small ones---matter)。多数 UI 场景用连字符。
UI 元素:按钮用动作动词、具体、尽量 2-3 词、不加句号和感叹号。错误信息说明发生了什么、原因(如有帮助)、下一步怎么做,如“Could not save changes. Check your connection and try again.”。空状态说明此处通常有什么并提供明确操作,可用 Sentry Voice,如“No projects yet. Create your first project to start tracking errors.”。确认对话框在标题中明确动作、说明破坏性后果、按钮用具体标签(如“Delete Project”而非“OK”)。工具提示和帮助文本不超过两句,解释“为什么”,复杂主题链接文档。
反模式:避免机器人式表达("Item has been successfully deleted"→"Deleted")、被动语态("Changes were saved"→"Changes saved")、多余词("In order to"→"To")、含糊("This might cause..."→"This will cause...")、双重否定("Not unlike..."→"Similar to...")、UI 中的营销腔("Supercharge your workflow"→"Speed up your workflow")。
限制:资料未提供该技能的安装命令、平台支持、收费或价格信息。