L05b 合作与署名:谁该写进作者栏,贡献怎样留下证据
署名同时是信用和责任:作者与致谢怎么分,Ghost 与 Gift 两种失衡,贡献矩阵按角色记账、代码仓库把劳动变成署名证据。含课件资深者当第一作者、贡献矩阵、五项贡献归类和可引用仓库四道题。
一句话版
写进作者栏,等于公开声明自己做了实质的知识贡献,并愿意为整份工作负责;够不上的帮忙写进致谢,所有贡献都要留下看得见的记录。
上半场讲的是怎样让自己的记录经得起追问,从 L05a 开始。这一页转到多人合作。
先认识这几个词
| 词 | 英文 | 一句人话 |
|---|---|---|
| 署名 | authorship | 论文作者栏写谁,写上就要同时担责任 |
| 致谢 | acknowledgement | 帮过忙但够不上作者的人写在这里 |
| 幽灵作者 | Ghost authorship | 做了实质贡献却没写进作者栏的人 |
| 挂名作者 | Gift authorship | 只因地位或关系被写进作者栏的人 |
| 贡献矩阵 | contribution matrix | 一张表,按角色勾选每个人做了什么 |
| Pull Request | 合并请求,常简称 PR | 在仓库里提交一组改动、请别人审查再合并 |
一个类比:电影片尾的字幕
一部电影的片尾字幕,回答的问题和论文作者栏一样:谁做了什么。
主创和鸣谢是两栏。导演、编剧、主演进主创,借过场地、出过钱的人进鸣谢。论文也是两栏:对设计、数据或分析有实质贡献的人进作者栏,提供经费、行政支持或语言润色的人通常进致谢。
字幕出错有两种方向:做了大量工作的人没出现在字幕里,或者没参与的人因为名气被挂上去。论文里这两种错各有名字,叫幽灵作者和挂名作者。
类比在一处失效:片尾字幕只记信用,不要求上面的人为影片里的每个错误负责;论文作者要对整份工作的诚信承担责任。
从零讲起
1. 作者和致谢:两栏怎么分
它解决什么问题
一个项目里有人设计实验、有人跑数据、有人申请经费、有人帮忙改英文。谁该写进作者栏?没有标准,就容易按资历、按关系拍板。
从哪来(补充)
医学期刊编辑国际委员会(ICMJE)的作者标准被很多期刊采用。它要求作者同时满足四条:对构思设计、或数据的获取分析解释有实质贡献;起草或批判性修订重要知识内容;批准最终发表版本;同意对工作的各方面负责。四条没有全满足的贡献者放进致谢。单纯获取经费、一般性指导、行政支持、语言编辑或校对,不构成作者资格。出处:ICMJE: Defining the Role of Authors and Contributors。
课件把前三条放在「谁是作者」一栏,把第四条单独放进「什么是问责」一栏。
直觉
课件的定义是:负责任的作者因实质的知识贡献获得信用,并承担对工作诚信的责任。信用和责任捆在一起,只取一样不算负责任的作者:挂名却拒绝担责,或者干了活却不给署名,都是失范。
课件底部一句话说得更直白:署名不是对资历或友情的奖赏,它是对重要知识贡献的公开声明,也是对共同问责的承诺。
一步一步看
目标:把五位贡献者逐个对照作者三条,看谁进作者栏、谁进致谢栏,「需确认」那格还差哪一步。
案例:一个项目里有五位贡献者,逐个判断进作者栏还是致谢栏。每一步看一个人,判断依据写在表里。
-
先列出五个人的贡献,再对照作者三条:实质知识贡献、起草或修订、批准终稿并担责。
贡献者 做了什么 实质知识贡献 起草或修订 批准并担责 归入 ① 设计了实验,写了方法一节 有 有 需确认 作者 ② 提供了实验室机时 无 无 无 致谢 ③ 申请到了经费 无 无 无 致谢 ④ 对讨论部分做了批判性改写,批准终稿 有 有 有 作者 ⑤ 帮忙润色英文 无 无 无 致谢 -
对表里「需确认」的那一格补一步:① 要审阅并批准终稿、同意对整份工作负责,才完全满足作者标准。
怎么判断
课件给了一张判别表,下半场最常用:
| 作者栏 | 致谢栏 |
|---|---|
| 对设计、数据或分析有实质贡献 | 一般性指导,或提供实验室空间 |
| 起草或批判性修订知识内容 | 经费获取,或行政支持 |
| 最终批准并对工作负责 | 技术编辑、校对或语言帮助 |
| 主要信用跟随知识贡献与责任 | 致谢仍然重要,但不等于署名 |
意思是:给一段贡献描述,问三件事,有没有实质知识贡献、有没有参与文字、愿不愿意担责。三件里缺得多的,进致谢。只出钱不构成署名,这是最常见的挂名借口,判别表右栏直接拆掉了它。
常见误解
以为进致谢就是贡献不重要
判别表右栏最后一句写着:致谢仍然重要,但不等于署名。致谢栏同样是公开记录,课件问责一栏也要求非作者贡献者得到公平致谢。
以为干的活多就一定是作者
还要看是不是知识贡献,以及愿不愿意为整份工作负责。按指示跑了大量重复实验但没参与设计和解释,要对照标准讨论,不会因工作量自动成为作者。
试一下
一位同学做了整个项目的数据清洗,参与了结果解释的讨论,但没写文字,也没看终稿。按作者三条,他现在够不够?怎样才够?
实质知识贡献有,数据整理和参与解释都算。起草或修订、批准终稿这两条还没做到。让他审阅并修订相关部分、批准终稿并同意担责,就够了;否则进致谢。
2. Ghost 与 Gift:两种方向相反的失衡
它解决什么问题
作者栏出错有两种方向:少写了该写的人,或多写了不该写的人。两种错修法不同,先要分清是哪一种。
从哪来(补充)
学术署名的讨论里,ghost authorship 指做了实质贡献的人没上作者栏,gift(也叫 honorary)authorship 指没起重要作用的人被给了署名。出处:Wikipedia: Academic authorship。
直觉
课件页脚写得很清楚:不要漏掉应得署名的贡献者(Ghost),不要只因地位授予署名(Gift)。
Ghost 是少写了人,常见于数据整理、写代码这类不进正文的劳动。Gift 是多写了人,常见于按资历、按职位挂名。两种都让作者栏和真实贡献对不上,过不了 Boundary Test 的第三问。
一步一步看
目标:拿一篇挂了系主任、漏了研究助理的论文逐问,看 Gift 和 Ghost 怎样在同一篇里同时出现。
案例:论文作者栏写了系主任,他只签过经费申请;却没写做了全部数据清洗的研究助理。
-
问有没有不该写的人。系主任只因职位挂名,是 Gift。
-
问有没有漏掉该写的人。研究助理做了实质数据工作,没被讨论,有 Ghost 风险。
-
问怎么修。摊开实际贡献表,按作者标准重排作者栏和致谢。
-
下结论:两种失衡方向相反,同一篇论文里可以同时出现。
怎么判断
| 问题 | 答「是」时 | 修法 |
|---|---|---|
| 作者栏里有人只因地位、关系或出钱被写上吗 | Gift | 移进致谢 |
| 有人做了实质知识贡献却不在作者栏吗 | Ghost | 按作者标准讨论署名,至少致谢 |
意思是:两个问题都要问,答完再修。只问一个,另一个方向的错就漏过去了。
常见误解
以为给老师或领导挂名是一种礼貌
课件把它明确叫作 Gift,是要避免的失衡。表达感谢的地方是致谢栏。
以为 Ghost 只发生在故意隐瞒的时候
更常见的是没人想到要讨论:清洗数据、写管道、做代码审查不进正文,很容易被忘掉。这正是下一个概念要用贡献矩阵解决的问题。
试一下
小组报告的作者栏写了四位组员。其中一位整个学期只来过一次组会,什么也没写;另一位外系同学帮忙写了核心算法,却没被列入。各是哪种失衡?
只来一次组会、没有贡献的那位组员被写上,是 Gift。写了核心算法却没被列入的外系同学,是 Ghost。
3. 让看不见的贡献看得见:贡献矩阵与仓库
它解决什么问题
讨论署名时,最容易吵起来的是「谁做得多」。没有记录,只能凭印象和资历。课件给了两样工具,把贡献变成可以摊开对照的证据:贡献矩阵和代码仓库。
从哪来(补充)
课件矩阵的列名来自 CRediT 贡献角色分类。完整的 CRediT 共有 14 个角色,除了课件列出的构思、数据整理、形式分析、写作,还有 Software、Validation、Supervision、Funding acquisition 等,2022 年成为 ANSI/NISO 标准。出处:CRediT。
课件提到的 CITATION.cff,是一个人和机器都能读的纯文本引用文件。放进仓库默认分支后,GitHub 会在仓库页右侧栏加上 “Cite this repository” 链接。出处:GitHub Docs: About CITATION files。
直觉
课件先讲为什么署名重要,列了三个维度:Credit,谁被认可;Accountability,谁来负责;Visibility,哪些劳动看得见。第三个维度是数据科学特有的痛点:清洗数据、写管道、做代码审查往往进不了作者栏,却决定结果能不能复现。
贡献矩阵按角色勾选,不按头衔排座。代码仓库更进一步:每次改动都有时间和人名,PR 记下了审查和讨论。Issues、PR、commit 三样合起来,就是 See who 这一问的工程实现。
一步一步看
目标:用三人项目的仓库记录填一张贡献矩阵,看每个勾怎样都有 Issues、PR 和 commit 作证据。
案例:三人项目快结束了,用代码仓库里的记录填一张贡献矩阵。
-
先列角色:构思、数据整理、形式分析、写作四列。
-
查 Issues:谁提出问题、记下设计决策,填进构思一列。
-
查 PR 和 commit:谁写清洗脚本、谁跑分析,填进数据整理和形式分析。
-
查文稿修订记录:谁起草、谁修改,填进写作一列。
-
下结论:每个勾都有仓库证据,讨论署名时摊开这张表。
怎么判断
仓库里三样东西,各提供一种署名证据:
| 仓库里的环节 | 记下什么 | 证明什么 |
|---|---|---|
| Issues 与讨论 | 定义目标、链接数据集、记录设计决策 | 谁参与了构思 |
| Pull Request 与审查 | 技术劳动、知识审查、集体改进 | 谁写了、谁审了 |
| Commit 历史 | 每次改动的时间和作者 | 沿时间线归属署名角色 |
意思是:矩阵上的每个勾,都应该能在仓库里指出对应的记录。指不出来的勾,就是需要讨论的勾。
想让别人能准确引用你的仓库,课件给了一套可引用仓库的起步包:README.md 写目的、安装、来源、局限;LICENSE 写别人可以怎么用;CITATION.cff 写怎么引用;Release tag 加 DOI 固定某次结果用的版本;CONTRIBUTING.md 写贡献、审查与信用规则。
常见误解
以为贡献矩阵要背全所有角色
课件给的是缩略版。考点是用角色而不是用头衔填格子,把「最资深的当第一作者」这个默认假设拆掉。
以为 commit 数量多就代表贡献大
commit 记下的是谁在什么时候改了什么,不是贡献大小的打分。一次重要的设计决策可能只在 Issue 里一段话,矩阵按角色记,不按次数记。
试一下
一个三人项目,仓库里 A 的 commit 最多,全是格式调整;B 在 Issue 里提出了核心方法,写了分析代码;C 写了报告初稿。按角色填矩阵,A、B、C 各勾哪几列?
B 勾构思和形式分析,C 勾写作。A 的格式调整不属于这四列中的知识贡献,矩阵里可以不勾,或在完整的 CRediT 分类里看能否归到别的角色,再讨论是否署名。
把它们串起来
署名同时是信用和责任。作者三条加上问责,划出作者栏和致谢栏的边界:有实质知识贡献、参与文字、批准终稿并担责的进作者栏,经费、行政、语言帮助进致谢。
作者栏错有两个方向,漏写该写的人是 Ghost,多写不该写的人是 Gift。两种错都源于没有证据可对照。
贡献矩阵按角色记账,代码仓库把每次改动和审查都留下时间和名字。有了这些记录,讨论署名就能摊开证据,不用比资历。
下一页讲作者怎么排序、署名协议怎样随项目更新,以及谈不拢时怎么办。
课件里的坑
- [读题提醒] p.22 矩阵只列了四个角色,是贡献角色分类的缩略版。考点是按角色填格,不是背全表
- [读题提醒] p.16 把作者标准放左栏、问责放右栏;很多期刊指南要求作者标准同时满足,答「谁是作者」时三条都要写,再补一句愿意担责
- [跨页对照] p.25 的 CITATION.cff 和 Release + DOI,与 p.13–14 的引用公式两端对称:别人引你的仓库靠前者,你引别人的仓库按后者写
课后 10 分钟:考点复习
这 10 分钟怎么用:合上页面,先默写作者与致谢判别表、Ghost 与 Gift、署名三个维度、可引用仓库五件;再做课件例题和变式题;最后回查一个易错点:贡献矩阵按角色填,不按头衔。
必背
- 负责任的作者同时拿走实质知识贡献的信用并承担诚信责任;署名不是资历或友情的奖赏
- 署名看知识贡献与责任;经费、行政、语言润色通常进致谢
- Ghost 是漏掉该写的人,Gift 是按地位挂名;两种失衡要分别检查
- 署名为什么重要:Credit 谁被认可、Accountability 谁来负责、Visibility 哪些劳动看得见
- 用贡献矩阵按角色而非头衔记账;仓库历史是署名证据
- 可引用仓库 Starter Pack:README / LICENSE / CITATION.cff / Release+DOI / CONTRIBUTING
课件例题
例 1(课件 p.17):「最资深的当第一作者」
见下方完整例题。
例 2(课件 p.20):把五项贡献归进两栏
题面:把下面贡献分别归入 Authorship 或 Acknowledgement:① 设计了实验并写了方法节;② 提供了实验室机时;③ 申请到了经费;④ 对讨论部分做了批判性改写并批准终稿;⑤ 帮助润色英文。
提示
对照判别表左右两栏,问每一项有没有实质知识贡献、有没有参与文字。
解答
① 和 ④ 进 Authorship:① 有实质贡献并起草了方法节,还需批准终稿;④ 做了批判性修订并批准终稿。② 提供实验室空间、③ 经费获取、⑤ 语言帮助,按判别表右栏进 Acknowledgement。
例 3(课件 p.22):读一张贡献矩阵
题面:矩阵示例中,Researcher A 勾了 Conceptualization、Formal Analysis、Writing;Researcher B 勾了 Data Curation、Formal Analysis;Researcher C 勾了 Conceptualization、Writing。这张表起什么作用?如果只按头衔排作者,谁的工作最容易被忽略?
提示
看副题 make invisible work visible;再想哪一列的工作不会出现在文稿正文里。
解答
矩阵按角色记账,副题是 Use a contribution matrix to make invisible work visible。它把讨论从「谁资深」改成「谁做了哪一块」。
最容易被忽略的是 B 的数据整理:不写进文稿正文,却是分析的前提。有了矩阵,这项劳动就有了可以对照的证据。
例 4(课件 p.25):可引用仓库起步包
题面:默写 Citable-Repository Starter Pack 五件。CITATION.cff 在 GitHub 上会触发什么界面元素?
提示
五件里两件是 .md 文件,一件是许可,一件管引用,一件管冻结版本。
解答
README.md、LICENSE、CITATION.cff、Release tag + DOI、CONTRIBUTING.md。GitHub 识别根目录的 CITATION.cff 后,会在仓库页右侧显示 “Cite this repository” 按钮。
完整例题
课件 p.17 原题:课件三格漫画。团队默认最资深的人当第一作者;接着有人摊开实际贡献表公开讨论;最后的结果是公平署名、写贡献声明、技术帮手进致谢、全体作者批准终稿。第一格的默认做法错在哪?页脚要避免的两种失衡是什么?
① 第一格错在依据。按地位定署名,不按知识贡献。课件 p.16 底部说署名不是对资历的奖赏,第一格正好违反了这一句。
② 这对应哪种失衡。只因地位被排到第一作者,属于 Gift 的来源。同时,按资历排座会让做了实际工作的人被往后挤甚至漏掉,带出 Ghost 风险。
③ 页脚两种失衡。Ghost 是漏掉应得署名的贡献者;Gift 是只因地位授予署名。两者方向相反,一个少写了人,一个多写了人。
④ 修法就是第二、三格。第二格摊开实际贡献表,用证据讨论。第三格的四个结果各有作用:公平署名对应作者标准;贡献声明让每个人做了什么公开可查;技术帮手进致谢对应判别表右栏;全体作者批准终稿对应作者第三条和问责。
⑤ 结论。默认资深者第一作者,错在以地位代替贡献。修法是用实际贡献说话,够得上的进作者栏,帮忙的进致谢,所有作者批准终稿。
变式题(先自己做)
自编情境:课程项目报告的作者栏写了导师姓名,导师只开过一次进度会、没改过文稿;没写负责数据清洗的助研 F。组里 G 的 commit 最多,主张自己应排第一。请:① 判断导师与 F 该署名还是致谢;② 指出这份作者栏里的失衡;③ 说明怎样用仓库记录回应 G 的主张。
提示
导师与 F 对照判别表;失衡分两个方向各问一次;G 的主张对照「矩阵按角色不按次数」。
判分点与答案
判分点:① 导师判为致谢,F 视实际贡献讨论署名或至少致谢;② 同时指出 Gift 与 Ghost;③ 说明 commit 数量不等于贡献大小,要按角色对照。
① 导师只开过一次进度会、未改文稿,属于一般性指导,进致谢。F 若做了实质数据整理,应进入贡献矩阵讨论署名;若只是按指示跑脚本,至少致谢。
② 导师因职位挂名是 Gift;漏掉 F 的实质贡献是 Ghost。
③ 打开仓库,按角色看 G 的 commit 改的是什么:是分析代码,还是格式调整。把 Issues、PR、commit 对照贡献矩阵的四列,按角色讨论排序,不按提交次数。
闪卡自测
1. 负责任作者的定义强调哪两件事绑在一起?
实质知识贡献的信用,与对工作诚信的责任(p.16)。
2. Ghost 与 Gift 各指什么?
Ghost 漏掉该写的人;Gift 按地位或关系挂名(p.17)。
3. 署名重要的三个维度?
Credit、Accountability、Visibility(p.19)。
4. 哪些贡献通常进致谢而不是署名?
一般指导或实验室空间、经费与行政支持、技术编辑、校对、语言帮助(p.20)。
5. 仓库工作流三环节各提供什么证据?
Issues 与讨论记设计决策;PR 与审查记技术劳动和知识审查;Commit 历史沿时间线归属署名角色(p.24)。
6. Citable-Repository Starter Pack 有哪五件?
README.md、LICENSE、CITATION.cff、Release tag + DOI、CONTRIBUTING.md(p.25)。
下一讲
下一页 L05b-2 讲作者顺序、署名活协议,以及谈不拢时的三段升级。
个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。