HbAssignmentHandUpAndReview

课程任务&笔记 提交及相互反馈 操作指南

课程任务&笔记提交，遵循一定的约定，才方便大家追踪和相互 review 。

目前暂行约定如下：

• 你完成任务后，回复成果到对应任务提交 Issue 中
• 提交任务时，点评上一位同学的成果
• 如果有心有力，可以追查其他学友的任务成果
  • 在 Issue 中给出心情 icon
    • 👍 点赞
    • ❤️ 喜欢
  • 像教练一样和学友互动反馈

具体操作动作，你可以通过下文详细了解：

• 如何提交 任务成果&笔记
• 如何相互反馈
• 如何了解学友输出和反馈动态
• 注意事项

如何提交 任务成果&笔记

GitHub 是一个优雅的版本管理工具，开智学堂常用 GitHub 作为课程主题讨论、提交&互评作业平台。

你可以通过网页版、客户端、Git 命令将文件提交到 GitHub 仓库，各种方式的操作指南视频见 HbAssignmentHandup。

如有时间，建议你使用客户端、Git 命令行管理 GitHub 仓库。这样效率更高也更易体会 GitHub 使用机制的精妙，给你思维习惯带来的影响更深远。如果实在来不及探索 GitHub ，可参考下文讲解提交每周成果。网页版提交最简单。

Step 1. Fork 课程仓库：

Step 2. 成功后，刷新页面，可以看到：

Step 3. 如果有指定提交路径，点击你要提交的路径，找到对应文件，点击编辑，然后保存即可。

如果没有指定提交路径，可直接点击「upload files」（上传文件），上传你的任务成果。

Step 4. 最后，复制此页面链接地址到你要提交任务的仓库，新建 Issue 发布自己的任务成果。

如何相互反馈

就着 自评维度清单 给同伴反馈，能让你更快熟悉这些要点。在 Python 基础班提交每章任务时，请你就着 自评维度清单 给上一位提交的同学反馈哦。反馈方式如下：

反馈维度

参考 Python 基础班自评/互评维度

• 点出 1-3 个亮点
• 给出 1-3 个改进建议

反馈方式

• 对具体代码/文字，到同学的 commit log 中对具体内容行进行增补、评注，比如 https://github.com/OpenMindClub/tacofancy/commit/b7abb9a5edeab97a25b6aea76e638308bf3528fc 。

• 然后将同学的 commit history 页面（进入方式如下图）链接附到你提交作业 issue 中，以便你楼上同学知道：

  

  点击 commit 即可进入 commit history 页面：

  

当然此处提醒一下：如果你不想错过同学给你的反馈，请一定开通邮件接收 GitHub 消息。配置方式详见：HbGitHubNotifyStu。

评注操作步骤

• 方式一：

  1. 点击同学仓库具体文件（比如代码、教程等）的右上角 history 按钮：

  2. 进入该文件历史改动页面，点击你想查看的 commit 信息：

  3. 即可进入文件改动页面进行评注：

• 方式二：

  1. 点击同学仓库首页 commit 按钮：

  2. 进入该仓库历史改动页面，点击你想查看的 commit 信息：

     

  3. 即可进入文件改动页面进行评注：

注意：要点击 commit 或 commit message 信息，才能进入改动页面。点击文件夹或文件名，只能进入文件页面哦。

除了相互反馈的方式，还有即时交流，比如当面/视频交流。

欢迎你自主发起活动互助交流，发起指南详见：HbOMeeupOrganizer · OpenMindClub/Share Wiki。

如何了解学友输出和反馈动态

除了在任务提交 Issue 中查看学友输出，你还可以通过以下方式了解学友输出动态：

1. watching 你感兴趣的学友仓库，选择你舒适的方式接收他们的动态：Managing notification delivery methods - User Documentation
2. 从 Dashboard (地址一般为 https://github.com/orgs/YourOrg/dashboard) 的信息流中查看，比如https://github.com/orgs/OpenMindClub/dashboard

CHANGELOG

• 180424 闪闪增补点击 commit message 和点击文件名的差异
• 170816 闪闪增补 commit history 页面
• 170814 闪闪增补如何给同学代码评注
• 170803 闪闪修订细节
• 170801 卓璇修订
• 170303 闪闪修订细节为通用版本
• 170306 云嫱迁移自 Py 仓库创建