CorTeX 文档打开 CorTeX
打开 CorTeX
浏览全部主题

通过评论审阅稿件

针对源码提问,与合作者讨论并记录决定,区分审阅与编辑。

本页内容

评论让审阅者讨论某段文字,而不改动源码。每个会话锚定一段文本范围,并随附近的协作编辑移动,适合询问论点、方法、公式或图注。

授予合适的审阅权限#

需要阅读和讨论但不应编辑时,将相关项目、文件夹、文件或选定文件组评论者角色共享。评论者链接要求登录。共享范围应包含理解段落所需的所有文件;获得一个 .tex 文件的权限,不会自动获得图片、参考文献或引入章节。

无需讨论时使用查看者,需要改动所覆盖源码时才使用编辑者共享项目说明完整的角色和范围边界。

发起聚焦的讨论#

选择足以说明问题的最小文本范围。在浮动的选区操作栏选择添加评论,写清需要决定的事项,再选择评论。新会话会在该源码范围打开,也会出现在侧栏的评论中。例如:

这个置信区间采用的是 methods.tex 中的自助法分析,还是参数敏感性分析?

明确问题比“请检查”更容易得到结论。指出证据、相关文件或投稿要求,不要粘贴接收者原本无权访问的敏感内容。

回复、修改和解决#

打开侧栏的评论,查看可访问文件中尚未解决的会话。选择会话即可打开对应文件和锚定段落。需要保留讨论记录时,在回复…中输入内容并选择回复。编辑者修改源码后,确认锚点仍覆盖目标段落,编译或渲染结果也正确。

问题已回答、约定修改已落实时,选择解决。以后修改使原决定不再适用时,选择显示已解决,打开会话并选择重新打开。评论作者可用删除评论删除自己的条目,但删除会丢失上下文;讨论对合作者仍有价值时,优先标记为解决。

评论与源码使用同一实时文档同步。离线时保持标签页打开,等待离线状态清除,再判断远端回复是否缺失或结束审阅。邮件通知不保证送达,当前会话状态以评论侧栏为准。

完成一轮审阅#

接受大量修改前,先保存命名版本。审阅结束时,确认没有阻碍投稿的未解决会话,编译主文档,再保存标识本轮审阅的版本。每项决定都应已解决且反映在源码中,或明确保持开放,并有负责人和下一步。

开始下一轮修改前,使用版本历史保存本轮审阅完成时的状态。