Skills Data Science JOS Artifact and Reproducibility Guidelines

JOS Artifact and Reproducibility Guidelines

v20260724
jos-artifact-evaluation
A comprehensive guide for authors submitting to the Journal of Software (JOS), clarifying the current status and best practices for including reusable code and data artifacts. It distinguishes JOS's approach from mandatory international conference badging systems, focusing instead on making reproducibility a strong, proactive addition to your submission.
Get Skill
406 downloads
Overview

《软件学报》代码与数据可用性 (Journal of Software Artifact Evaluation)

本技能澄清《软件学报》(Journal of Software, JOS) 对 artifact(代码/数据可用性)的现状, 并给出恰当准备。与 ACM/IEEE 国际会议不同,本刊目前没有公开的强制 artifact 评审轨道与 徽章体系(现状 待核实,见 resources/official-source-map.md);因此这里的目标 是"把可复现材料做成加分项",而非套用国际会议的 badging 流程。

一、现状:无强制轨道,但可用性是加分

  • 本刊未见公开的独立 artifact evaluation track 或"Available/Reusable"徽章制度。
  • 但提供可访问、可复现的代码/数据,能显著增强审稿人对结果的信任(见 jos-reproducibility)。
  • 因此策略是:主动、恰当地提供材料,而非等待强制要求。

二、把可复现材料做成加分项

  • 在论文中给出清晰的可用性声明与稳定链接,而非"可根据要求提供"。
  • 材料附 README,能从零复现主要表/图;提供环境(容器/依赖清单)。
  • 若涉及隐私/版权无法公开,给出脱敏样本、合成数据或评测协议作替代。

三、专刊与 ChinaSoft 联动的可能要求

  • 部分专刊(special issue)由特约(客座)编辑组稿,可能对材料、评测协议提出额外要求。
  • CCF ChinaSoft 中国软件大会联动的专刊,可能要求先作口头报告或提交演示材料。
  • 投专刊前,到专刊征稿页核对是否有代码/数据、演示、评测方面的具体要求。

四、归档与许可选择

[ ] 代码托管:稳定仓库(含发布 tag / commit 固定)
[ ] 大数据/大文件:归档平台(Zenodo/校内镜像)+ DOI 或稳定链接 + 校验和
[ ] 许可:开源许可(如 MIT/Apache-2.0/GPL 视情况),数据许可单独声明
[ ] 合法性:确认可分享(无版权/隐私问题),必要时脱敏

五、与国际会议 artifact badging 的差异

维度 国际会议(ACM/IEEE) 《软件学报》现状
评审轨道 独立 AE track 无公开强制轨道(待核实)
徽章 Available/Functional/Reusable/Reproduced 无公开徽章体系
时机 录用后单独截稿 无固定 AE 截稿
定位 影响正式认定 增强说服力的加分项

不要把国际会议的 badging 术语与流程照搬进本刊投稿,避免误导。

六、准备自检清单

[ ] 已确认本刊/目标专刊对 artifact 的当前要求(到官网/征稿页核对)
[ ] 论文有可用性声明与稳定链接(非"可根据要求提供")
[ ] 材料含 README,可从零复现主要结果
[ ] 环境已固定(容器/依赖清单)
[ ] 归档渠道与许可已定,材料合法可分享
[ ] 若投专刊:核对演示/评测/材料的额外要求

七、输出格式

【artifact 策略】恰当提供(加分)/ 专刊要求驱动 / 暂不公开(给替代)
【本刊现状】无公开强制轨道(待核实,以官网为准)
【可用性声明】链接是否稳定:________
【专刊要求】是否有额外材料/演示要求:________
【归档与许可】方案:________
【下一步】用 jos-reproducibility 打磨材料 / 用 jos-supplementary 组织附录

八、材料成熟度分级(自评你的可用性到了哪一档)

为避免"要么不给、要么过度工程化",把材料成熟度分成几档,按投稿目标选择合适的一档,不必 一步到位追求国际会议 Reusable 级别:

  • 第 0 档 只有声明:论文仅写"可根据要求提供"。这是弱项,审稿人无法核验,尽量避免。
  • 第 1 档 可见:提供公开仓库链接,代码与关键脚本可读,但复现步骤不完整。适合快速加分。
  • 第 2 档 可复现:附 README、环境说明与一键脚本,第三方能重复主要表/图。这是本刊语境下 性价比最高、最值得追求的一档。
  • 第 3 档 可复用:文档完善、接口清晰、他人能在自己的数据上复用你的方法。适合方法类、 工具类论文,也便于后续被引用与二次开发。

对多数投向《软件学报》(Journal of Software) 的研究论文,达到第 2 档即可显著增强说服力; 方法/工具类或计划开源推广的工作可争取第 3 档。综述类论文若含分类基准或数据集,也可提供 数据侧材料。

九、与出版流程的衔接

  • 录用后定稿阶段(见 jos-camera-ready)确认材料链接在见刊 时仍然稳定有效,避免"论文见刊、链接失效"。
  • 若材料随论文以补充材料形式提交,其组织与正文引用见 jos-supplementary
  • 归档时优先使用能长期保存并提供稳定标识(DOI)的平台,减少链接腐烂风险。

十、常见误区

  • 照搬 ACM/IEEE 徽章术语,声称本刊有 AE track——现状并非如此,属 待核实 需核对。
  • 只写"可根据要求提供",停留在第 0 档,错失加分。
  • 忽略专刊的额外材料要求,投稿后才发现。
  • 上传含版权/隐私数据的材料,带来合规风险。
  • 为追求"可复用"过度工程化,反而拖延投稿——按目标选合适档位即可。

十一、输出格式

【材料档位】第0档声明 / 第1档可见 / 第2档可复现 / 第3档可复用
【本刊/专刊要求】已核对官网与征稿页:________(现状待核实)
【归档许可】平台与许可:________
【与出版衔接】见刊时链接是否稳定:________
【下一步】用 jos-reproducibility 补齐到第2档 / 用 jos-supplementary 组织提交

综上,在《软件学报》(Journal of Software) 语境下,对 artifact 的正确态度是"主动提供、恰到 好处、合法可分享":既不因为无强制要求而完全不给,也不照搬国际会议的重型 badging 流程徒增 负担。把可复现材料做扎实,本身就是对软件学科研究诚信的体现。

提醒:本刊是否新增 artifact 政策、专刊具体要求,均属 待核实,请以《软件学报》(Journal of Software) 官网投稿指南与 CCF ChinaSoft 专刊征稿页为准。工具适配见 resources/code/README.md

Info
Category Data Science
Name jos-artifact-evaluation
Version v20260724
Size 6.92KB
Updated At 2026-07-28
Language