SharedResources

本仓库用于存放课程相关的原始资源文件，例如课件、教材、作业资料、图片、压缩包等。

整理后的课程信息、Markdown 试卷正文、教师评价与课程说明应放在 SharedCourses，不要放在本仓库。

目录结构

资源按课程代码归档：

SharedResources/
├── SE/
│   └── SE1210/
├── SFLE/
│   └── SFLE0030/
├── SFLK/
│   └── SFLK3117/
└── PHYS/
    └── PHYS1502/

规则：

• 第一层目录为课程代码的字母前缀（即院系英文缩写），如 SE、SFLE、SFLK、PHYS。
• 第二层目录为完整课程代码，如 SE1210、SFLK3117。
• 不在本仓库使用中文学院名或中文课程名作为课程外层目录。
• 课程代码以 SharedCourses 中对应课程的 course_code 为准。

课程目录内部

课程代码目录内部按照 SharedCourses 的 CODE_OF_CONDUCT.md 中课程页面层级组织。外层用课程代码规范化，课程内按学期、教师和资源类型归档。

常见结构如下：

SE/SE2424/
└── 2023-2024学年下学期/
    ├── 教师A/
    │   └── 教学资源/
    └── 推荐教材与参考资料/

规则：

• 能确认教师归属的教学资源，放在对应学期和教师目录下的 教学资源/ 中。
• 无法确认教师归属的资源，放在对应课程或学期的 推荐教材与参考资料/ 中。
• 教材、参考书、通用资料放在 推荐教材与参考资料/ 中。
• 试卷 PDF 原则上应在 SharedCourses 中转写为 Markdown，不作为主要展示资源直接挂出；原始试卷文件如需保留，只作为校对和追溯资料。
• 迁移旧资源时，尽量保留资源在课程内部的原有布局，但应服从上述学期、教师、教学资源和推荐资料层级。

如果旧资源路径包含中文学院名或中文课程名，只在迁移时用于定位来源，不应保留为课程外层目录。

例如旧路径：

软件工程学院/形式语言与自动机理论/2023-2024学年下学期

应迁移为：

SE/SE2424/2023-2024学年下学期

命名建议

• 尽量保留原始文件名，避免破坏资料来源和版本信息。
• 不额外加入中文课程名作为目录层级。
• 同一课程下不同学期、教师、资源类型可以用子目录区分。
• 临时文件、系统文件和缓存文件不要提交，例如 .DS_Store、*.part、__pycache__/。