用户手册V0.1.2

01水杉码园教师使用手册（精简版）/水杉码园教师使用手册（精简版）.md

@@ -16,9 +16,9 @@
 
 页面跳转至“创建课程页”，按提示填写相关信息，单击“创建课程”完成课程创建。
 
-![image-20210222201403202](image/image-20210222201403202.png)
+注意：作业最大次数默认为10次，教师可根据开课过程中布置的作业次数设置该值，因创建课程后该值不可修改，建议设置作业最大次数略大于实际作业次数。
 
-![image-20210222201434428](image/image-20210222201434428.png)
+![image-20210311193918556](image/image-20210311193918556.png)
 
 单击右上角的“访问课程”按钮进入课程主页。
 
@@ -36,13 +36,17 @@
 
 课程成员包括课程教师、助教、全体选课学生。
 
-#### 1.2.1 逐个添加学生
+#### 1.2.1 助教
 
-在课程首页单击“添加学生”按钮，在搜索框中输入学生相关信息（学号或姓名）找到该学生，单击“添加团队成员”完成单个学生的添加。
+在课程首页的右侧有课程团队模块，"Owners"团队中的成员为课程的管理员，包括教师及助教。
 
-首次创建课程添加学生建议使用批量导入学生功能。
+单击"Owners"，进入“Owners”团队管理页，在搜索框中搜索助教人员相关信息，在下拉的提示菜单中选择相应的助教，单击“添加团队成员”即可完成助教添加。
 
-![image-20210222202840044](image/image-20210222202840044.png)
+助教在本课程中拥有和教师相同的操作权限。
+
+![image-20210222210440745](image/image-20210222210440745.png)
+
+![image-20210222212344881](image/image-20210222212344881.png)
 
 #### 1.2.2 批量导入学生
 
@@ -62,7 +66,11 @@
 
 ![image-20210222205319297](image/image-20210222205319297.png)
 
-由于学生未在系统中注册等原因，部分学生可能会导入失败，教师可在课程首页单击“管理成员”，详细核对课程中已经导入的学生信息。
+由于学生未在系统中注册等原因，部分学生可能会导入失败，教师会收到导入学生是否成功的相关邮件（可能需要等待较长时间），如有部分学生未导入成功，在邮件中会列出相关学生的信息。
+
+教师可在课程首页单击“管理成员”，详细核对课程中已经导入的学生信息。
+
+重复导入学生不会对课程中已经存在的学生造成影响。
 
 ![image-20210222205810783](image/image-20210222205810783.png)
 
@@ -72,68 +80,48 @@
 
 ![image-20210306165807551](image/image-20210306165807551.png)
 
-#### 1.2.3 助教
-
-在课程首页的右侧有课程团队模块（课程团队相关概念及操作在1.3节中进行详细说明），单击"Owners"，进入“Owners”团队管理页，在搜索框中搜索助教人员相关信息，单击“添加团队成员”即可完成助教添加。助教在本课程中拥有和教师相同的操作权限。
-
-![image-20210222210440745](image/image-20210222210440745.png)
-
-![image-20210222212344881](image/image-20210222212344881.png)
-
-在上述页面中，单击“移除成员”可以移除相关助教。
-
-![image-20210222212526751](image/image-20210222212526751.png)
-
-#### 1.2.4 课程成员移除
-
-随着课程的进行，一些课程成员可能会离开课程。
-
-在课程首页单击“管理成员”，页面跳转后在左侧可勾选需要删除的课程成员，单击右上角的“批量移除成员”按钮可以移除选中的课程成员。
-
-![image-20210222213452723](image/image-20210222213452723.png)
-
-
-
-![image-20210222213911339](image/image-20210222213911339.png)
 
 
+### 1.3 课程资料上传
 
-### 1.4 课程设置
-
-在课程首页单击“课程管理”，页面跳转后可以对课程的相关详细进行更新。
-
-![image-20210222223826154](image/image-20210222223826154.png)
+在上传课程资料前必须先批量导入学生（参考1.2.2节说明），导入学生后系统自动创建“AllStu”仓库。
 
-![image-20210222223957274](image/image-20210222223957274.png)
+资料上传使用“AllStu”仓库，该仓库对所有课程成员可见，对非课程成员不可见。
 
+![image-20210306165347613](image/image-20210306165347613.png)
 
+单击“AllStu”进入该仓库，可以通过新建文件夹、上传文件等功能上传课程资料。其中，上传文件功能可以同时上传多个文件。
 
+![image-20210306170828282](image/image-20210306170828282.png)
 
+![image-20210311201236000](image/image-20210311201236000.png)
 
-### 1.5 课程资料上传
+仓库中有“话题”模块，教师可以通过“创建话题”的方式对上传资料的进行说明，也可以通过“创建话题”的方式发布通知、作业、上传作业相关附件。
 
-在上传课程资料前必须先批量导入学生（参考1.2.2节说明），导入学生后系统自动创建“AllStu”仓库。
+![image-20210311201629803](image/image-20210311201629803.png)
 
-资料上传使用“AllStu”仓库，该仓库对所有课程成员可见，对非课程成员不可见。
 
-![image-20210306165347613](image/image-20210306165347613.png)
 
-单击“AllStu”进入该仓库，可以通过新建文件夹、上传文件等功能上传课程资料。其中，上传文件功能可以同时上传多个文件。
+![image-20210311202032777](image/image-20210311202032777.png)
 
-![image-20210306170828282](image/image-20210306170828282.png)
+同学们也可以在话题中跟帖讨论。
 
-仓库中有“话题”功能，教师可以通过“创建话题”的方式对上传资料进行说明，也可以通过“创建话题”的方式发布通知、作业等。
+![image-20210311202348583](image/image-20210311202348583.png)
 
 ## 三、作业管理
 
 ### 3.1 作业下载
 
-课程成员将作业提交到以各自的成员名命名的仓库中，根据作业次序的不同，需提交到不同仓库分支。
+课程学生将作业提交到以各自学号命名的仓库中，根据作业次序的不同，需提交到不同仓库分支。
+
+例如第一次作业统一提交到各自学号命名的仓库中的homework00分支中。
 
 ![image-20210222231726094](image/image-20210222231726094.png)
 
 课程管理员可以在课程首页下载所有仓库中指定分支的内容。
 
+下图是下载所有学生仓库中homework03分支下的作业示例。
+
 ![image-20210222232014854](image/image-20210222232014854.png)
 
 
@@ -149,3 +137,15 @@
 单击上图中的“设置评分权重”，可以设置各项分数的权重。系统会加权赋分给出学生分数。
 
 ![image-20210222233331675](image/image-20210222233331675.png)
+
+单击排行榜右侧的数字处，可查看学生提交数量、提问数量、回答数量等信息。
+
+提交数量：学生在课程中提交作业、代码的次数
+
+提问数量：学生在仓库话题中的发帖条数
+
+回答数量：学生在仓库话题中的跟帖条数
+
+![image-20210311203622602](image/image-20210311203622602.png)
+
+![image-20210311203329179](image/image-20210311203329179.png)

02水杉码园教师使用手册（详细版）/水杉码园教师使用手册（详细版）.md

@@ -10,37 +10,43 @@
 
 在首页中选择创建课程，单击左上角头像处，在下拉菜单中选择“ + 创建课程”进行课程创建。
 
-![image-20210222200528159](image/image-20210222200528159.png)
+![image-20210222200528159](image/image-20210222200528159-1615470337452.png)
 
 
 
 页面跳转至“创建课程页”，按提示填写相关信息，单击“创建课程”完成课程创建。
 
-![image-20210222201403202](image/image-20210222201403202.png)
+注意：作业最大次数默认为10次，教师可根据开课过程中布置的作业次数设置该值，因创建课程后该值不可修改，建议设置作业最大次数略大于实际作业次数。
 
-![image-20210222201434428](image/image-20210222201434428.png)
+![image-20210311193918556](image/image-20210311193918556.png)
 
 单击右上角的“访问课程”按钮进入课程主页。
 
-![image-20210222201912579](image/image-20210222201912579.png)
+![image-20210222201912579](image/image-20210222201912579-1615470337467.png)
 
 也可以通过首页右侧的课程模块访问相关课程。
 
-![image-20210222202408124](image/image-20210222202408124.png)
+![image-20210222202408124](image/image-20210222202408124-1615470337468.png)
 
-![](image/image-20210222202150492.png)
+![](image/image-20210222202150492-1615470337468.png)
 
-![image-20210222202457727](image/image-20210222202457727.png)
+![image-20210222202457727](image/image-20210222202457727-1615470337468.png)
 
 ### 1.2 成员管理
 
 课程成员包括课程教师、助教、全体选课学生。
 
-#### 1.2.1 逐个添加学生
+#### 1.2.1 助教
 
-在课程首页单击“添加学生”按钮，在搜索框中输入学生相关信息（学号或姓名）找到该学生，单击“添加团队成员”完成单个学生的添加
+在课程首页的右侧有课程团队模块（课程团队相关概念及操作在1.3节团队管理中进行详细说明），单击"Owners"，进入“Owners”团队管理页，在搜索框中搜索助教人员相关信息，单击“添加团队成员”即可完成助教添加。助教在本课程中拥有和教师相同的操作权限。
 
-![image-20210222202840044](image/image-20210222202840044.png)
+![image-20210222210440745](image/image-20210222210440745.png)
+
+![image-20210222212344881](image/image-20210222212344881.png)
+
+在上述页面中，单击“移除成员”可以移除相关助教。
+
+![image-20210222212526751](image/image-20210222212526751.png)
 
 #### 1.2.2 批量导入学生
 
@@ -60,21 +66,21 @@
 
 ![image-20210222205319297](image/image-20210222205319297.png)
 
-由于学生未在系统中注册等原因，部分学生可能会导入失败，教师可在课程首页单击“管理成员”，详细核对课程中已经导入的学生信息。
+由于学生未在系统中注册等原因，部分学生可能会导入失败，教师会收到导入学生是否成功的相关邮件（可能需要等待较长时间），如有部分学生未导入成功，在邮件中会列出相关学生的信息。
 
-![image-20210222205810783](image/image-20210222205810783.png)
+教师可在课程首页单击“管理成员”，详细核对课程中已经导入的学生信息。
 
-#### 1.2.3 助教
+重复导入学生不会对课程中已经存在的学生造成影响。
 
-在课程首页的右侧有课程团队模块（课程团队相关概念及操作在1.3节中进行详细说明），单击"Owners"，进入“Owners”团队管理页，在搜索框中搜索助教人员相关信息，单击“添加团队成员”即可完成助教添加。助教在本课程中拥有和教师相同的操作权限。
+![image-20210222205810783](image/image-20210222205810783.png)
 
-![image-20210222210440745](image/image-20210222210440745.png)
+#### 1.2.3 逐个添加学生
 
-![image-20210222212344881](image/image-20210222212344881.png)
+在课程首页单击“添加学生”按钮，在搜索框中输入学生相关信息（学号或姓名）找到该学生，单击“添加团队成员”完成单个学生的添加
 
-在上述页面中，单击“移除成员”可以移除相关助教。
+注意：使用逐个添加学生功能，系统不会自动创建“AllStu”仓库(该仓库对所有学生可见，可用于存放课程资料)，一般建议使用批量导入学生功能添加学生。
 
-![image-20210222212526751](image/image-20210222212526751.png)
+![image-20210222202840044](image/image-20210222202840044.png)
 
 #### 1.2.4 课程成员移除
 
@@ -327,13 +333,17 @@ $ git push [remote] --all
 
 ### 3.1 作业下载
 
-课程成员将作业提交到以各自的成员名命名的仓库中，根据作业次序的不同，需提交到不同仓库分支。
+课程学生将作业提交到以各自学号命名的仓库中，根据作业次序的不同，需提交到不同仓库分支。
+
+例如第一次作业统一提交到各自学号命名的仓库中的homework00分支中。
 
-![image-20210222231726094](image/image-20210222231726094.png)
+![image-20210222231726094](image/image-20210222231726094-1615470146942.png)
 
 课程管理员可以在课程首页下载所有仓库中指定分支的内容。
 
-![image-20210222232014854](image/image-20210222232014854.png)
+下图是下载所有学生仓库中homework03分支下的作业示例。
+
+![image-20210222232014854](image/image-20210222232014854-1615470146941.png)
 
 
 
@@ -343,8 +353,20 @@ $ git push [remote] --all
 
 在课程首页的右下角展示了积分排行榜。
 
-![image-20210222232958063](image/image-20210222232958063.png)
+![image-20210222232958063](image/image-20210222232958063-1615470176887.png)
 
 单击上图中的“设置评分权重”，可以设置各项分数的权重。系统会加权赋分给出学生分数。
 
-![image-20210222233331675](image/image-20210222233331675.png)
+![image-20210222233331675](image/image-20210222233331675-1615470176888.png)
+
+单击排行榜右侧的数字处，可查看学生提交数量、提问数量、回答数量等信息。
+
+提交数量：学生在课程中提交作业、代码的次数
+
+提问数量：学生在仓库话题中的发帖条数
+
+回答数量：学生在仓库话题中的跟帖条数
+
+![image-20210311203622602](image/image-20210311203622602.png)
+
+![image-20210311203329179](image/image-20210311203329179.png)