语言与项目命名
使用简洁、平等、直接的语言。说明事实和下一步,不使用行政命令口吻,也不过度使用“亲”“小伙伴”“温馨提示”等运营化表达。
- 推荐:“登录已过期,请重新登录。”
- 避免:“尊敬的用户,十分抱歉地通知您登录状态可能出现异常。”
- 推荐:“删除后无法恢复。”
- 避免:“是否确认执行此操作?”
同一产品中的概念名词须保持唯一性。首度出现的缩写需附带原理解释;开发者专业术语仅限在受众可理解的前提下使用。中文正文中的英文品牌名需保留原始拼写;文件名、命令及代码标识符采用代码样式标记。
代码仓库命名需使用易读的英文或课程缩写加项目名,避免引入无意义编号、全角字符或冗长名称。README 首屏须同时说明中文项目名称、一句话简介、当前维护状态及适用边界。
组织级名称遵循:
- 中文:重庆理工大学开源计划
- 英文:CQUT Open Project
- 简称:CQUT-OSP
- GitHub:CQUT-OpenProject
动作与状态文案
Section titled “动作与状态文案”操作按钮建议采用“动词+受事”格式,如“创建仓库”、“复制令牌”、“重新同步”;状态指示则说明具体结果,如“已保存”、“同步失败”、“等待审核”。避免同一词汇在页面中同时充当页面名称、对象名称和操作名称。
面向中文用户优先使用 2026-07-11 或 2026 年 7 月 11 日。涉及截止时间和跨区域操作时标明 Asia/Shanghai 或 UTC 偏移。数字和单位之间按界面上下文统一,例如 16 px、24 MB。