目录
目录README.md

Git4Edu | 开放课程系统协作开发Upstream仓库

Course as Code Community as Class Open Source Education Status MVP Release R1 License CC BY-SA 4.0

1. 仓库定位

Git4Edu 并非一个“课程资料合集仓库”,而是一个正在运行的课程改革实践仓库。

本仓库用于探索并验证一种新的教学运行范式:将课程视为一个可运行、可协作、可演进、可治理的系统(Course as Code), 而不仅是一组静态教学内容。因此,Git4Edu 中的结构、流程、协作方式本身,就是课程改革实验的一部分。

Git4Edu 以开源协作为核心主仓(Upstream Repository),用于支撑高校与职业院校的开源课程体系共建、教学运行与持续演进

本仓库将课程视为一种可协作、可版本化、可复用的工程资产,通过 Git 与开源协作机制,构建“教学—实践—产出”一体化的课程运行模式。

对接专业:

  • 职业本科:开源技术开发与应用(310216)
  • 高职专科:开源技术应用(510220)

2. 课程设计理念

本课程体系遵循三条核心原则:

  • Course as Code
    课程内容即代码,讲义、实验、案例与规范全部以仓库形式管理,支持版本演进与协作共建。

  • Class as Community
    班级即社区,教学过程通过 Issue / PR / Review 的方式组织,而非单向授课。

  • Learning by Contributing
    学习以真实贡献为核心,学生在参与协作中完成能力成长与成果积累。


3. 课程体系架构设计

Git4Edu完整实现开源学习栈(OSLS)架构,将教学活动系统化为五个协同层级:

层级 名称 关注点
L1 Outcome Stack(能力栈) 学生最终可验证的能力产出
L2 Collaboration Stack(协作栈) Issue / PR / Review / Release
L3 Toolchain Stack(工程栈) Git 平台、CI、模板
L4 Courseware Stack(内容栈) 讲义、实验、案例
L5 Community Stack(社区栈) 班级运营与激励

Git4Edu 主要承载 L2–L4 的核心资产,并为能力评价(L1)与社区运行(L5)提供基础支撑。


4.仓库结构说明

Git4Edu用“仓库体系”代替“教研群文件”,设计原则采用所有内容都应是 可复用、可协作、可引用 的课程资产,而非一次性教学材料。在此基础上,课程整体采用 “三仓一板” 的最小协作架构,以较低的复杂度实现完整的教学协作闭环:

Git4Edu仓库和数据体系结构:
├── 📦 Git4Edu(本仓库) - 课程主仓:标准化课程资产源
├── 🏫 班级组织仓 - 教学运行仓:各班级教学实例
├── 🎓 学生作品仓 - 成果展示仓:学生个人/小组作品集
└── 📋 课程协作看板 - 可视化看板:教学任务与进度管理

5. 技术与理论文档入口

本仓库同步维护开放课程系统相关的文档,用于解释本开放课程系统和开源教育背后的设计逻辑、边界与适用条件。

📘 建议从以下文档开始阅读:

技术和理论说明文档

实践计划说明文档

工作坊实施文档


⚠️ 说明:
这些文档并非“教材内容”,而是课程运行与教学改革的技术说明书


6. 协作方式

6.1 Git4Edu采用标准的开源协作流程

1. 发现需求 → 创建或认领 Issue
2. 讨论方案 → 在 Issue 评论区达成共识
3. 实现代码 → Fork → 本地开发 → 提交
4. 代码评审 → 创建 Pull Request → 等待 Review
5. 合并发布 → 通过 CI 检查 → Maintainer 合并 → 发布 Release

6.2 代码规范

- **文档提交**:使用 Markdown 格式,遵循现有文档结构
- **实验代码**:提供完整可运行的示例,包含详细注释
- **配置模板**:使用 YAML/JSON 格式,提供配置说明
- **提交信息**:遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范

6.3 贡献类型

可贡献内容包括但不限于:

贡献类型 适合人群 流程指引
课程内容贡献 教师、领域专家 修改 CURRICULUM/LABS_AND_EXERCISES/
教学资源贡献 教师、实践者 添加 COMMUNITY_RESOURCES/ 中的案例或指南
工具改进贡献 开发者、DevOps 优化 TOOLING_AND_CI/ 中的自动化流程
问题修复与反馈 所有使用者 提交 Issue 或修复文档错误
翻译与本地化 多语言贡献者 提交课程材料的翻译版本

7. 仓库角色

角色 说明
维护者 负责仓库结构、质量兜底与版本发布
贡献者 提交课程内容与改进
评审者 参与评审与质量保障
社区导师 提供工程与教学视角指导

⚠️ 重要说明: 核心维护者与关键贡献者并非无偿贡献者。 其持续性、高责任的维护与共建行为,将纳入课程的激励与评估体系。


8. 激励与评价机制

Git4Edu采用数据驱动的激励与评估机制

  • 基于 Issue / PR / Review / Release 等真实协作数据
  • 明确区分核心维护贡献、核心内容贡献与一般贡献
  • 通过贡献证明、署名、生态推荐及必要的经济激励进行兑现

目标不是追求贡献数量,而是保障高质量协作的可持续性


9. 许可证

本项目源代码采用 MIT License 进行许可,允许在满足许可证条款的前提下,自由地使用、复制、修改、合并、发布、分发、再许可和/或销售软件的副本。

所有研究成果(包括但不限于论文、数据、图表、模型、方法论描述等)默认使用 知识共享署名-相同方式共享 4.0 国际许可协议 (CC BY-SA 4.0) 进行许可。

关于

Git4Edu是一个以 Course as Code为核心理念的开源课程Upstream仓库,面向高校教学场景,将课程讲义、实验与作业流程工程化、版本化与协作化,把教学过程转化为可复用、可追溯、可持续演进的公共教育资源。

11.9 MB
邀请码
    Gitlink(确实开源)
  • 加入我们
  • 官网邮箱:gitlink@ccf.org.cn
  • QQ群
  • QQ群
  • 公众号
  • 公众号

©Copyright 2023 CCF 开源发展委员会
Powered by Trustie& IntelliDE 京ICP备13000930号