Skip to content

贡献方式

Issue、PR、纠错、资料、选课/考试攻略,完全欢迎!来自大家的关注、维护和贡献,才是让这个攻略继续存在的动力!

我们鼓励使用 GitHub 自带的方法提交贡献,对于实在不懂技术的同学,可以发邮件至此邮箱,注明 “OpenISE” 即可:Timlinjq@gmail.com 或者 3365768302@qq.com

贡献内容

我们欢迎:

  • 往年真题与复习资料:为已有资料的课程补充带答案的历年真题,或提交高质量的复习笔记与总结;
  • 空白课程的资料填充:为尚未收录或资料匮乏的课程提交基础资料,帮助完善课程覆盖范围;
  • 课程评价与建议:提交尽量客观的课程简介、复习建议或选课建议,建议附上昵称与 GitHub 账号以便署名与追溯;

我们不欢迎:

  • 带有明显个人情绪或主观偏见的评价:包括对教师的贬义描述、情绪化表达或人身攻击。选课建议应基于客观的课程特点、考核方式、作业难度、工作量等事实性描述,而非个人好恶;
  • 大量来源不明的题目或答案:无法确认来源的习题、考题、答案合集,由于不同学校考试范围和难度差别巨大,我们不是特别鼓励这部分内容的大量提交。

我们同样欢迎高年级同学或校友以贡献者身份分享个人经历与见解——无论是学业规划、保研或出国的心路历程,还是 AI 时代下的技能转型思考,都是对低年级同学极具参考价值的内容。

对于这些同学,请查阅博客贡献方式

贡献方式

对于文件类资料,可以直接在对应的文件夹处添加文件。而如果是课程简介、复习建议和选课建议,则需要以markdown格式提交,这种语言非常简单,对应规则如下:

  • 如果该课程已有 README.md,请在文件中找到对应的标题并在其下方补充内容。
  • 如果该课程目录下尚无 README.md,请自行创建,并参考其他课程的 README.md 格式进行组织。

注意:README.md开头必须是以#开头的一级标题,写上这门课程的名字。

资料按照2024级的课程安排排列,其课程安排可以在Github 仓库中查看

都最好署上你的昵称以及 GitHub主页/邮箱。

GitHub Web 端上传方式

由于本项目体积很大(约 5G 左右),除了使用传统的全部文件 clone 到本机,可以采用在 GitHub Web 端直接上传的方式,具体操作如下:

1. Fork 本项目

首先 Fork 本项目,点击右上角的 Fork 按键即可。

2. 上传文件

2.1. 上传文件到已有文件夹

打开对应文件夹,点击绿色 Download 按钮旁的 upload,上传你的文件,或编辑文件。

image-20260410120506649
2.2. 上传文件到新文件夹

打开任意文件夹,点击绿色 Download 按钮旁的 upload,把浏览器地址栏中文件夹名称改为你想要新建的文件夹名称,然后回车,上传你的文件。

3. 提交 PR

3.1 提交 Pull Request

上传完成并 Commit 后,回你的 Fork 页面,点击 Contribute → Open Pull Request,填写说明后提交。

3.2 通过 Issue 提交

也可以直接附加在 Issue 中,由维护者进行添加。

示例

比如我是 2100 春季学期年上的,想在自控原理上传一个自己的作业,首先找到自控原理对应的文件夹(智能科学与技术/大二下/自动控制原理/),然后在自控原理文件夹下新建文件夹 2100年秋季学期,然后往里面填文件即可。如果想要提供文字建议,则需要修改README.md这个文件。

其他贡献方式说明

如果发现错误、想提出建议、请求添加资料,都可以通过提交 Issue的方式来贡献。

博客贡献方式

博客不同于上述的课程文件的提交地址,需要前往网页仓库提交 PR,往/content/blog中创建md文件,同样要求使用 markdown 写作,同时附上你的昵称和 GitHub 账号/邮箱。注意开头应当标注元数据:

---
title: "文章标题"
date: 20xx-04-15
author: "[你的昵称](你的GitHub账号)"
description: "文章简介"
---
正常开始写作,不需要写标题。

我们同样鼓励通过 GitHub 提交以减小维护者的工作量,如果实在无法通过 GitHub 可以通过发送邮件的形式投稿。