【助教】做業基本要求

提交時間

  • 按時交 - 有分
  • 晚交 - 0分
  • 遲交一週以上 - 倒扣本次做業分數
  • 抄襲 - 倒扣本次做業分數

注:針對遲交的做業,建議先倒扣本次做業分數,學生須要補交完之後聯繫助教方能修改分數。html

如下是在點評了不少做業之後發現的很常見的問題,有必要總結一下,不然每次都要提一遍(歡迎建議和補充)。

作不到的,將直接倒扣本次做業的分數!

博客中的連接

博客連接必須是能夠點擊的:git

如:github

博客地址web

或:編程

http://www.cnblogs.com/greyzeng/編程語言

如下兩種狀況的連接不符合要求:版本控制

  • 連接不可點擊,如:

http://www.cnblogs.com/greyzeng/code

  • 連接顯示地址和連接實際地址不符合,如:

http://www.cnblogs.com/greyzeng/htm

顯示連接爲:http://www.cnblogs.com/greyzeng/
實際跳轉的連接倒是:https://github.com/greyzengblog

博客中插入代碼

博客開頭

若是是針對某個做業提交的博客,須要在博客開頭註明做業的地址,

格式爲:

做業的要求來自於:

http://www.javashuo.com/article/p-xrlttpdi-o.html

若是涉及代碼,還須要在博客開頭給出存放代碼的倉庫地址

格式爲:

代碼所在的github遠程倉庫的地址:

https://github.com/GreyZeng/calculator

源碼提交

不是項目中全部文件都要提交到代碼倉庫中,
如IDE的配置文件,編譯的臨時文件夾等都是不要提交到版本控制裏面去的,因此項目在提交到版本控制裏面的時候要忽略特殊文件

這裏是各類類型的編程語言/IDE的gitignore的一些參考模板

規範提交信息說明

提交代碼的時候,須要輸入本次提交的代碼說明(commit message),不少同窗的提交說明都是毫無心義的,如:

如何編寫Commit message,請看這個文檔
Commit message 和 Change log 編寫指南-阮一峯

一個好的例子

關鍵代碼說明

凡是和代碼相關的博客,都要有 關鍵代碼 的說明(不是貼全部代碼
還要有 程序運行的截圖

一個好的例子

團隊做業

  • 每一個團隊只須要 一個團隊博客一個團隊代碼倉庫,團隊成員的我的博客沒必要每次複製團隊博客,團隊做業統一提交到團隊博客(須要加入班級博客中)中,代碼統一提交到團隊代碼倉庫中,每次交做業的時候,只須要附上團隊博客和團隊代碼倉庫地址便可。

  • 對於團隊代碼倉庫,每一個團隊成員都要有簽入代碼的記錄。

項目的部署運行

不管是我的項目仍是團隊項目,都必須有一個文檔說明:如何在一臺全新的電腦上部署運行大家的程序。

相關文章
相關標籤/搜索