← DSAI5T09 全部讲次
L05b · 第 6 周

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。

课件把前三条放在「谁是作者」一栏,把第四条单独放进「什么是问责」一栏。

直觉

课件的定义是:负责任的作者因实质的知识贡献获得信用,并承担对工作诚信的责任。信用和责任捆在一起,只取一样不算负责任的作者:挂名却拒绝担责,或者干了活却不给署名,都是失范。

课件底部一句话说得更直白:署名不是对资历或友情的奖赏,它是对重要知识贡献的公开声明,也是对共同问责的承诺。

一步一步看

目标:把五位贡献者逐个对照作者三条,看谁进作者栏、谁进致谢栏,「需确认」那格还差哪一步。

案例:一个项目里有五位贡献者,逐个判断进作者栏还是致谢栏。每一步看一个人,判断依据写在表里。

  1. 先列出五个人的贡献,再对照作者三条:实质知识贡献、起草或修订、批准终稿并担责。

    贡献者 做了什么 实质知识贡献 起草或修订 批准并担责 归入
    ① 设计了实验,写了方法一节 有 有 需确认 作者
    ② 提供了实验室机时 无 无 无 致谢
    ③ 申请到了经费 无 无 无 致谢
    ④ 对讨论部分做了批判性改写,批准终稿 有 有 有 作者
    ⑤ 帮忙润色英文 无 无 无 致谢
  2. 对表里「需确认」的那一格补一步:① 要审阅并批准终稿、同意对整份工作负责,才完全满足作者标准。

怎么判断

课件给了一张判别表,下半场最常用:

作者栏 致谢栏
对设计、数据或分析有实质贡献 一般性指导,或提供实验室空间
起草或批判性修订知识内容 经费获取,或行政支持
最终批准并对工作负责 技术编辑、校对或语言帮助
主要信用跟随知识贡献与责任 致谢仍然重要,但不等于署名

意思是:给一段贡献描述,问三件事,有没有实质知识贡献、有没有参与文字、愿不愿意担责。三件里缺得多的,进致谢。只出钱不构成署名,这是最常见的挂名借口,判别表右栏直接拆掉了它。

常见误解

以为进致谢就是贡献不重要

判别表右栏最后一句写着:致谢仍然重要,但不等于署名。致谢栏同样是公开记录,课件问责一栏也要求非作者贡献者得到公平致谢。

以为干的活多就一定是作者

还要看是不是知识贡献,以及愿不愿意为整份工作负责。按指示跑了大量重复实验但没参与设计和解释,要对照标准讨论,不会因工作量自动成为作者。

试一下

一位同学做了整个项目的数据清洗,参与了结果解释的讨论,但没写文字,也没看终稿。按作者三条,他现在够不够?怎样才够?

实质知识贡献有,数据整理和参与解释都算。起草或修订、批准终稿这两条还没做到。让他审阅并修订相关部分、批准终稿并同意担责,就够了;否则进致谢。

2. Ghost 与 Gift:两种方向相反的失衡

它解决什么问题

作者栏出错有两种方向:少写了该写的人,或多写了不该写的人。两种错修法不同,先要分清是哪一种。

从哪来(补充)

学术署名的讨论里,ghost authorship 指做了实质贡献的人没上作者栏,gift(也叫 honorary)authorship 指没起重要作用的人被给了署名。出处:Wikipedia: Academic authorship。

直觉

课件页脚写得很清楚:不要漏掉应得署名的贡献者(Ghost),不要只因地位授予署名(Gift)。

Ghost 是少写了人,常见于数据整理、写代码这类不进正文的劳动。Gift 是多写了人,常见于按资历、按职位挂名。两种都让作者栏和真实贡献对不上,过不了 Boundary Test 的第三问。

一步一步看

目标:拿一篇挂了系主任、漏了研究助理的论文逐问,看 Gift 和 Ghost 怎样在同一篇里同时出现。

案例:论文作者栏写了系主任,他只签过经费申请;却没写做了全部数据清洗的研究助理。

  1. 问有没有不该写的人。系主任只因职位挂名,是 Gift。

    判断帧第 1 步:案例是作者栏写了只签经费申请的系主任、没写做数据清洗的研究助理;第一行问有没有不该写的人被高亮,答案是系主任只因职位挂名,属于 Gift

  2. 问有没有漏掉该写的人。研究助理做了实质数据工作,没被讨论,有 Ghost 风险。

    判断帧第 2 步:第一行已答,第二行问有没有漏掉该写的人被高亮,答案是研究助理做了实质数据工作没被讨论,有 Ghost 风险

  3. 问怎么修。摊开实际贡献表,按作者标准重排作者栏和致谢。

    判断帧第 3 步:前两行已答,第三行问怎么修被高亮,答案是摊开实际贡献表,按作者标准重排作者栏和致谢

  4. 下结论:两种失衡方向相反,同一篇论文里可以同时出现。

    判断帧第 4 步:三行答案全部列出,底部结论框写着两种失衡方向相反,同一篇论文里可以同时出现

怎么判断

问题 答「是」时 修法
作者栏里有人只因地位、关系或出钱被写上吗 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 作证据。

案例:三人项目快结束了,用代码仓库里的记录填一张贡献矩阵。

  1. 先列角色:构思、数据整理、形式分析、写作四列。

    判断帧第 1 步:案例是三人项目用仓库记录填贡献矩阵;第一行先列角色被高亮,答案是构思、数据整理、形式分析、写作四列

  2. 查 Issues:谁提出问题、记下设计决策,填进构思一列。

    判断帧第 2 步:第一行已答,第二行查 Issues 被高亮,答案是谁提出问题、记下设计决策,对应构思

  3. 查 PR 和 commit:谁写清洗脚本、谁跑分析,填进数据整理和形式分析。

    判断帧第 3 步:前两行已答,第三行查 PR 和 commit 被高亮,答案是谁写清洗脚本、谁跑分析,对应数据整理和形式分析

  4. 查文稿修订记录:谁起草、谁修改,填进写作一列。

    判断帧第 4 步:前三行已答,第四行查文稿修订记录被高亮,答案是谁起草、谁修改,对应写作

  5. 下结论:每个勾都有仓库证据,讨论署名时摊开这张表。

    判断帧第 5 步:四行答案全部列出,底部结论框写着每个勾都有仓库证据,讨论署名时摊开这张表

怎么判断

仓库里三样东西,各提供一种署名证据:

仓库里的环节 记下什么 证明什么
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、署名三个维度、可引用仓库五件;再做课件例题和变式题;最后回查一个易错点:贡献矩阵按角色填,不按头衔。

必背

  1. 负责任的作者同时拿走实质知识贡献的信用并承担诚信责任;署名不是资历或友情的奖赏
  2. 署名看知识贡献与责任;经费、行政、语言润色通常进致谢
  3. Ghost 是漏掉该写的人,Gift 是按地位挂名;两种失衡要分别检查
  4. 署名为什么重要:Credit 谁被认可、Accountability 谁来负责、Visibility 哪些劳动看得见
  5. 用贡献矩阵按角色而非头衔记账;仓库历史是署名证据
  6. 可引用仓库 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 讲作者顺序、署名活协议,以及谈不拢时的三段升级。

下一讲 →
L05b-2 L05b-2 作者顺序、活协议与争议:先谈好,常更新,谈不拢按序升级

个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。