publications 贡献指南从零到发出第一个 PR 的完整流程【免费下载链接】publicationsPublications from Trail of Bits项目地址: https://gitcode.com/GitHub_Trending/pu/publications第一次打开 publications 仓库你看到的可能不是代码而是一张 14 万字节的大表论文、安全审计报告、演讲幻灯片的集中目录。它是 Trail of Bits 的出版物目录库——整个仓库由 Markdown 表格加 PDF 组成你贡献的功能通常就是给这张大目录精准地添一行。正因为没有编译和测试环节这里特别适合完全没提交过 PR 的新手练手改动范围小规则全写在文档里做错了也能一眼看出来。先把仓库拉到本地git clone https://gitcode.com/GitHub_Trending/pu/publications提示这个仓库不安装依赖、不跑测试。它的正确性完全靠 Markdown 格式本身——所以后文所有检查项用的都是肉眼和搜索而不是 CI。新增一条目录记录最常见的贡献长什么样翻一遍历史改动会发现绝大多数 PR 就干三件事把一个 PDF 放进对应目录、在根 README 的对应表格加一行、如果有演讲建一个子目录。新增记录时按下面顺序动手确定内容属于哪一节。README.md 顶部就是目录各节之间有固定先后顺序学术论文、白皮书、演讲、播客、安全审计……新条目永远插在该节表格的最上面——每节内部按时间倒序排列最新的在最前。复制相邻一行的格式。以安全审计表为例表头是| Product | Date | Effort | Announcement | Report |新行必须和表头的竖线数量一致缺数据的格子用空单元格补上不能截断。日期一律写三字母月份如Jul 2025不要写July也不要写四个字母的Sept。改完之后先别急着提交做两件事验证数一下新行和表头的竖线是不是同样多确认它插在表格第一数据行之前。新建演讲目录presentations/ 的规矩给一次演讲归档是稍微复杂一点的贡献。打开 presentations/ 看几个现成目录就能摸到门道每个演讲单独占一个文件夹幻灯片 PDF 和辅助材料与一个带 YAML frontmatter 的 README.md 放在一起。图presentations/ 目录下的演讲幻灯片截图这类材料会随演讲 README 一起归档新建目录时最容易翻车的三个点目录名只用演讲标题本身不带会议名、城市或年份。演讲在多个场合讲过就放同一个目录里存多个幻灯片版本。frontmatter 字段要齐title、date能精确到日就写 YYYY-MM-DD否则 YYYY-MM 或 YYYY、authors、conference、resources本地文件用path外部链接用url。根 README 里的链接要 URL 编码目录名含空格时链接写成presentations/How%20to%20Fuzz%20Like%20a%20Pro这种形式显示标题和目录名是解耦的。提交前自查清单PR 被退回前先过一遍这里仓库里的 CLAUDE.md 把维护者的排版细则全写出来了提 PR 前对照检查月份只用三字母缩写Jan、Feb……Dec每一行的竖线数量必须与表头完全一致空单元格写作| |不留空格差异Product 列只放干净的产品名不要带 Security ReviewSmart Contracts 这类后缀词报告图标固定含义 审计报告、✅ 修复复审、 证明函、 威胁模型多个文档写在同一行、图标间不留空格同一产品的重复条目要合并别留两行。注意只做排版调整时永远不要动 URL 和文件路径移动章节时正文和 README 顶部的目录TOC要一起更新。另外提交一律走新分支提 PR不要直接推 master。第一次动手从最小改动开始挑一条最容易的练手把某行表格里写错的Sept改成Sep或者补齐某行缺失的空单元格。改动小到几乎不可能破坏版式却完整走完克隆、建分支、自查、提 PR 的全流程。改完把这一行对着上节清单逐条核对一遍然后推上去——仓库里每一条记录都是这样一行行攒起来的。【免费下载链接】publicationsPublications from Trail of Bits项目地址: https://gitcode.com/GitHub_Trending/pu/publications创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考