背景
PR #9 引入的两类仓库级问题在后续 PR(#12 已修复站内页面死链)中仍未处理,需要单独清理。这些问题不影响构建出的站点,但影响仓库本身的可用性。
问题 1:根目录文件名大小写冲突(影响最大)
仓库根目录同时存在 CODE_OF_CONDUCT.md 和 code-of-conduct.md 两个文件。在大小写不敏感的文件系统(Windows NTFS、macOS APFS 默认配置)上 checkout 本仓库时两个文件互相覆盖,工作区会持续显示「已修改」状态,Windows/macOS 贡献者无法正常使用仓库。CI 跑在 Linux 上所以未拦截。
修复:二者内容近似(都指向 iflytek/community),保留 GitHub 社区健康文件标准命名的 CODE_OF_CONDUCT.md,删除 code-of-conduct.md,并将站内引用统一指向保留文件。
问题 2:README 与 contributing.md 死链
README.md 的 Contributing 一节链接 CONTRIBUTING.md(大写),但仓库中实际文件是 contributing.md(小写)。GitHub 文件路径大小写敏感,该链接 404。建议把文件重命名为标准的 CONTRIBUTING.md(同时规避与问题 1 同类的隐患),或修正 README 链接。
contributing.md 是从 iflytek/community 仓库整篇照搬的,内部相对链接(governance.md、community-membership.md、code-of-conduct.md、contribute/issue-guidelines.md、contribute/pull-request-guidelines.md 等)指向的文件在本仓库不存在,全部 404。建议改为指向 https://github.com/iflytek/community/blob/master/... 的绝对链接(注意 community 仓库默认分支是 master 不是 main)。
验收标准
背景
PR #9 引入的两类仓库级问题在后续 PR(#12 已修复站内页面死链)中仍未处理,需要单独清理。这些问题不影响构建出的站点,但影响仓库本身的可用性。
问题 1:根目录文件名大小写冲突(影响最大)
仓库根目录同时存在
CODE_OF_CONDUCT.md和code-of-conduct.md两个文件。在大小写不敏感的文件系统(Windows NTFS、macOS APFS 默认配置)上 checkout 本仓库时两个文件互相覆盖,工作区会持续显示「已修改」状态,Windows/macOS 贡献者无法正常使用仓库。CI 跑在 Linux 上所以未拦截。修复:二者内容近似(都指向 iflytek/community),保留 GitHub 社区健康文件标准命名的
CODE_OF_CONDUCT.md,删除code-of-conduct.md,并将站内引用统一指向保留文件。问题 2:README 与 contributing.md 死链
README.md的 Contributing 一节链接CONTRIBUTING.md(大写),但仓库中实际文件是contributing.md(小写)。GitHub 文件路径大小写敏感,该链接 404。建议把文件重命名为标准的CONTRIBUTING.md(同时规避与问题 1 同类的隐患),或修正 README 链接。contributing.md是从 iflytek/community 仓库整篇照搬的,内部相对链接(governance.md、community-membership.md、code-of-conduct.md、contribute/issue-guidelines.md、contribute/pull-request-guidelines.md等)指向的文件在本仓库不存在,全部 404。建议改为指向https://github.com/iflytek/community/blob/master/...的绝对链接(注意 community 仓库默认分支是master不是main)。验收标准
git clone后git status干净README.md中所有相对链接可达contributing.md(或重命名后的CONTRIBUTING.md)内所有链接可达,指向 community 仓库的链接使用master分支.prettierignore等处对这些文件的引用同步更新