Guide

課程導覽

介紹

我們在這學期做了一個新嘗試，將作業的撰寫、繳交與 Git 結合，並將課程網站放上 GitHub ，目的是提高各位的修課體驗，並嘗試與現今資訊世界接軌。

如果有什麼問題，請各位不要害怕到 討論區 發問。你是修課生，你有的問題其他學生也一定會有，幫助你自己的同時也是在幫助其他同學，同時還能讓教授知道課程有什麼問題需要調整。

這學期將課成內容交由 GitHub 代管，作業使用 Git 繳交能帶來許多好處，以下列出幾點讓大家能稍微理解理解。

1. GitHub 網站的穩定性比 E3 高

身為交大的學生可能體驗過在作業死線來臨前 1 分鐘繳交作業，e3 直接直接死掉不回應，或是在期末考週學校 E3 伺服器壞掉各位無法瀏覽的慘況。把課程的網站跟作業繳交 托管到 GitHub 這類擁有多主機的跨國公司能大幅提升網站穩定性，讓大家能隨時瀏覽相關內容。同時，我們也可以利用 GitHub 提供的 伺服器紀錄 判斷是否有因為伺服器下線讓作業無法繳交的情況，斟酌延後作業死線。

2. GitHub 當作你的遠端備份

你只需要一個指令就能將程式碼放上 GitHub，讓你能很簡單的備份自己的作業，降低誤刪自己作業檔案的風險。

3. 強迫各位使用版本控管

或許各位上大學唸資工從來沒聽過版本控管，或只是單純沒機會使用。沒關係，這堂課會讓你透過使用最低限度的 Git 來練習版本控管。甚至運用 Git 輔助自己未來的專案開發流程。 可能一開始用 Git 會有些不方便，甚至看起來有點多餘。但你既然都已經繳學費來學習，不妨多花點心力學會一些可以輔助你工作的工具吧！

組織導覽

我們把這個課程中所有內容都放在一個Github組織下: compiler-f19，而這個組織中會包含兩個所有修課生會使用到的 Repo (Repository)。

+ compiler-f19              ——  課程開的 GitHub Organization
    + Discussion            ——  討論版
    + Compiler-f19-private  ——  修課生的專屬內容

Compiler-f19-private 是於修課生才能擁有的內容，比如：每次作業的邀請代碼、考古題連結、整理好的某些筆記內容（助教如果還有時間會做喇…）、考試的答案解析。同學必須要申請加入組織才有權限瀏覽。

各版連結

除了 Discussion 外我們還有一個簡單的聊天室，提供同學用較輕便的方式進行對話，在上面問問題可以直接 tag 助教，我們也會收到通知的。

加入流程

註冊 GitHub 帳號

請注意，你只是在 GitHub 上註冊一個代表你個人的帳號，並且暫時加入我們的課程組織，在這之後的漫漫開發生涯中一定還會使用到這個帳號，所以會一定程度的代表你個人，建議仔細思考好帳號的名稱。 比如說 nctuGreatAgain, UCMaoChung5566, dutyForOurCountry 都是不推薦的名稱。

若已有Github帳號的同學可以略過這步驟。

申請 GitHub 帳號連結： 點我

填表單

請在我們的 Google 表單中填上你的資料 (必須要登入)，讓我們能夠將各位同學的 GitHub 帳號跟真實身份關聯在一起，在助教收到表單並確認為修課生後，會將各位填入的 Github 帳號加入組織，而 GitHub 網站會依此發出邀請信到信箱中。當各位收到信並確認接受後就算正式加入這堂課程了。👍

加退選期限過後會再用新的修課名單來更新組織裡的學生，不幸沒選上卻想旁聽且留在 Github 組織內的同學請知會老師與助教一聲。

表單的 Google 連結：點我

加入組織

這個步驟是助教會做的，你只要上 Github 網站確認你有被加入組織即可。助教會在（）公告已經將哪些同學加入組織中，若你發現助教已經將你加入組織而你的 Github 帳號並未顯示你已被加入組織，請來信詢問助教。

開啟通知

開啟通知後在你參與的 Repo 下有任何改動都會在 Github 網站通知你。

Personal Settings > Notifications > Participating > Web[打勾]

申請 HW0，熟悉環境

首先點擊 https://github.com/compiler-f19/Compiler-f19-private/tree/master/Homework 並且點擊作業的邀請連結，若你發現點進網站後沒有正常顯示網站，可能是你沒有登入 GitHub 或是你還沒被加入組織中，請登入 GitHub 或是等待加入組織後再次嘗試。

Changed Sep 9, 2019