通过评论审阅稿件
针对源码提问,与合作者讨论并记录决定,区分审阅与编辑。
本页内容
评论让审阅者讨论某段文字,而不改动源码。每个会话锚定一段文本范围,并随附近的协作编辑移动,适合询问论点、方法、公式或图注。
授予合适的审阅权限#
需要阅读和讨论但不应编辑时,将相关项目、文件夹、文件或选定文件组以评论者角色共享。评论者链接要求登录。共享范围应包含理解段落所需的所有文件;获得一个 .tex 文件的权限,不会自动获得图片、参考文献或引入章节。
无需讨论时使用查看者,需要改动所覆盖源码时才使用编辑者。共享项目说明完整的角色和范围边界。
发起聚焦的讨论#
选择足以说明问题的最小文本范围。在浮动的选区操作栏选择添加评论,写清需要决定的事项,再选择评论。新会话会在该源码范围打开,也会出现在侧栏的评论中。例如:
这个置信区间采用的是
methods.tex中的自助法分析,还是参数敏感性分析?
明确问题比“请检查”更容易得到结论。指出证据、相关文件或投稿要求,不要粘贴接收者原本无权访问的敏感内容。
回复、修改和解决#
打开侧栏的评论,查看可访问文件中尚未解决的会话。选择会话即可打开对应文件和锚定段落。需要保留讨论记录时,在回复…中输入内容并选择回复。编辑者修改源码后,确认锚点仍覆盖目标段落,编译或渲染结果也正确。
问题已回答、约定修改已落实时,选择解决。以后修改使原决定不再适用时,选择显示已解决,打开会话并选择重新打开。评论作者可用删除评论删除自己的条目,但删除会丢失上下文;讨论对合作者仍有价值时,优先标记为解决。
评论与源码使用同一实时文档同步。离线时保持标签页打开,等待离线状态清除,再判断远端回复是否缺失或结束审阅。邮件通知不保证送达,当前会话状态以评论侧栏为准。
完成一轮审阅#
接受大量修改前,先保存命名版本。审阅结束时,确认没有阻碍投稿的未解决会话,编译主文档,再保存标识本轮审阅的版本。每项决定都应已解决且反映在源码中,或明确保持开放,并有负责人和下一步。
开始下一轮修改前,使用版本历史保存本轮审阅完成时的状态。