tfs alert

develop_normal.md

@@ -9,14 +9,41 @@
   
 3. 將最新的 develop 分支 pull 到本地
   
-4. 在最新的 develop 分支新建工作單的分支分支名稱為 - Dev_Feature/#單號_工作單標題，ex: Dev_Feature/#4257_P40異常排除。
+4. 在最新的 develop 分支新建工作單的分支，分支名稱為 - Dev_Feature/#單號_工作單標題，ex: Dev_Feature/#4257_P40異常排除。
   
-5. 開發完後，先將最新的 develop 分支 pull 下來。(應該可以不用)
+5. (!!!重要) 開發完後，先將最新的 develop 分支 pull 下來，Merge 到 Dev_Feature中，避免有衝突。
   
-6. 所以檔案開發完後，commit 後 push 上 tfs。
+6. Merge完沒問題，commit 後 push 上 tfs。
   
-7. 到 tfs 申請合版(merge 至 develop)。  
+7. 到 tfs 申請合版(merge 至 develop)。(!!!重要 - 要選擇合併到哪個分支)  
 ![申請合版](images/tfs_merge_request.png)
   
-8. 填寫 API 上版項目  
+8. [填寫 API 上版項目](#API-上版項目說明)  
-![API 上版項目](images/document_api.png)
+![API 上版項目](images/document_api.png)
+
+
+## Master Hotfix
+
+1. 到 tfs 依工作需求建立工作號  
+
+2. 填寫工作單內容  
+
+3. 將最新的 master 分支 pull 到本地  
+
+4. 在最新的 master 分支新建工作單的分支，分支名稱 - Master_HotFix/#單號_工作單標題，ex: Master_HotFix/#4257_P40異常排除
+
+5. (!!!重要) 開發完後，先將最新的 master 分支 pull 下來，Merge 到 Master_HotFix中，避免有衝突。  
+
+6. Merge完沒問題，commit 後 push 上 tfs。
+
+7. 到 tfs 申請合版(merge 至 master)。
+
+8. 再申請合版 (merge 到 developer)，因為正常的合版流程是先 develop => master，如果只有合到 master 的話，下一個流程，develop 合到 master，因為沒有這次修改的程式，這樣會有問題。
+
+9. [填寫 API 上版項目](#API-上版項目說明)  
+
+## API 上版項目說明
+### Stage_20200514_PRD_20200527 => Stage_20200528_PRD_20200610  
+- 2020/05/14 develop 分支會 merge 至 master 分支，並 build 至 Stage 環境。
+- 2020/05/14 前修改的如果要在2020/05/14放到Stage，2020/05/27放到PRD，可以用Dev_feature，修改完成後merge到develop，會在5/14 merge到master並建立Stage環境，5/27 merge 到 PRD 並建立 PRD 環境
+- 2020/05/14~2020/05/27 之間想要在2020/05/27放到PRD，需要用Master_HotFix，修改完後merge到master分支，會在 5/27 merge 到 PRD 並建立 PRD 環境

gitflow.md

@@ -25,44 +25,21 @@
 ### 上版流程
 正常開發，兩星期上版一次，所以整個流程是以兩個星期為週期在重複。
 
-<table style="background-color: #1E1E1E; width: 100%">
+![上版時程](images/git_schedule_all.png)
-<tbody>
+
-<tr>
+連續多個版本的流程就像以下圖示  
-    <td style="width: 25%; color: white;" colspan=3></td>
+![多版本上版時程](images/git_schedule_multi.png)
-    <td style="width: 25%; color: white; vertical-align: bottom; text-align: center;" colspan=3>第一週<br>星期四<br>develop merge to Master</td>
+
-    <td style="width: 25%; color: white; vertical-align: bottom; text-align: center;" colspan=3>第二週<br>星期三<br>Master merge to PRD</td>
-    <td style="width: 25%; color: white;" colspan=3></td>
-</tr>
-<tr>
-    <td colspan=12>
-    <img src="images/git_schedule_arrow.png" style="width:100%; height: 100%">
-    </td>    
-</tr>
-<tr>
-    <td style="width: 33%; color: white; text-align: center;" colspan=4>develop 開發</td>
-    <td style="width: 33%; color: white; text-align: center;" colspan=4>Stage 測試</td>
-    <td style="width: 33%; color: white; text-align: center" colspan=4>PRD上線</td>
-</tr>
-<tr>
-    <td style="width: 33%; color: white; text-align: left; vertical-align: top;" colspan=4>1. 功能開發使用Dev_Feature分支<br>
-    2. 開發完後提取要求，合併至develop 分支</td>
-    <td style="width: 33%; color: white; text-align: left; vertical-align: top;" colspan=4>1. develop 分支合併至 Master<br>
-    2. 如果有需要修改，使用Master_HotFix</td>
-    <td style="width: 33%; color: white; text-align: left; vertical-align: top;" colspan=4>1. 上線至PRD環境<br>
-    2. 如需要修改，使用PRD_HotFix分支</td>
-</tr>
-</tobdy>
-</table>
 
 #### Ex:
 2020-04-27 Stage _ 2020-05-06 PRD：  
 - 2020-04-27 之前  
   開發全部用 Dev_Feature 分支，開分支使用 tfs 取得工作單號、標題，開發完後，申請合併(提取要求)至 develop 分支。
-- 2020-04-27 當天 
+- 2020-04-27 當天  
-  把 develop 分支合併到 Master 分支，並建置、部署至 Stage 環境
+  把 develop 分支合併到 Master 分支，並建置、部署至 Stage 環境  
 - 2020-04-27~2020-05-06  
   在 Stage 環境中測試，如果有問題，使用 Master_HotFix 分支修改
-- 2020-05-06 當天
+- 2020-05-06 當天  
   Master 分支合併至 PRD 分支，並建置、部署至 PRD 環境
 - 2020-05-06 之後  
   如果在 PRD 環境有什麼問題，需要緊急修正的話，使用 PRD_HotFix 分支修改，做緊急上版。

html/git_schedule_all.md

@@ -0,0 +1,28 @@
+<table style="background-color: #1E1E1E; width: 100%">
+<tbody>
+<tr>
+    <td style="width: 25%; color: white;" colspan=3></td>
+    <td style="width: 25%; color: white; vertical-align: bottom; text-align: center;" colspan=3>第一週-星期四<br><span style="font-weight: bold; color: #94D8F6"><span style="color: #22B04C">develop</span> merge to <span style="color: #FEF100" >Master</span><br>build and deploy to <span style="color: #FEF100">Stage</span></span></td>
+    <td style="width: 25%; color: white; vertical-align: bottom; text-align: center;" colspan=3>第二週-星期三<br><span style="font-weight: bold; color: #94D8F6"><span style="color: #FEF100">Master</span> merge to <span style="color: #FE0000">PRD</span><br>build and deploy to <span style="color: #FE0000">PRD</span></span></td>
+    <td style="width: 25%; color: white;" colspan=3></td>
+</tr>
+<tr>
+    <td colspan=12 style="padding: 8px 0px;">
+    <img src="images/git_schedule_arrow.png" style="width:100%; height: 100%; margin: 0px;">
+    </td>    
+</tr>
+<tr>
+    <td style="width: 33%; color: black; text-align: center; background-color: #22B04C;" colspan=4>develop 開發</td>
+    <td style="width: 33%; color: black; text-align: center; background-color: #FEF100;" colspan=4>Stage 測試</td>
+    <td style="width: 33%; color: black; text-align: center; background-color: #FE0000;" colspan=4>PRD上線</td>
+</tr>
+<tr>
+    <td style="width: 33%; color: white; text-align: left; vertical-align: top;" colspan=4>1. 功能開發使用Dev_Feature分支<br>
+    2. 開發完後提取要求，合併至develop 分支</td>
+    <td style="width: 33%; color: white; text-align: left; vertical-align: top;" colspan=4>1. develop 分支合併至 Master<br>
+    2. 如果有需要修改，使用Master_HotFix</td>
+    <td style="width: 33%; color: white; text-align: left; vertical-align: top;" colspan=4>1. 上線至PRD環境<br>
+    2. 如需要修改，使用PRD_HotFix分支</td>
+</tr>
+</tobdy>
+</table>

html/git_schedule_multi.md

@@ -0,0 +1,63 @@
+<style>
+table { background-color: #1E1E1E; width: 100%; }
+/*table tr td { border: 1px solid white; }*/
+table tr td { text-align: center; }
+table tr td.seperate { border-right: 3px solid white; }
+
+table tr td.develop { background-color: #22B04C; color: black; }
+table tr td.stage { background-color: #FEF100; color: black; }
+table tr td.PRD { background-color: #FE0000; color: black;}
+
+</style>
+
+<table>
+<tbody>
+<tr>
+    <td class="weekday"></td>
+    <td colspan=2 class="weekday">第一週-星期四</td>
+    <td colspan=2 class="weekday">第二週-星期三</td>
+    <td colspan=2 class="weekday">第三週-星期四</td>
+    <td colspan=2 class="weekday">第四週-星期三</td>
+    <td class="weekday"></td>
+</tr>
+<tr>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2></td>
+</tr>
+<tr>
+    <td colspan=2 class="develop seperate">develop</td>
+    <td colspan=2 class="stage seperate">Stage</td>
+    <td colspan=2 class="PRD seperate">PRD</td>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2></td>
+</tr>
+<tr>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2></td>
+</tr>
+<tr>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2 class="develop seperate">develop</td>
+    <td colspan=2 class="stage seperate">Stage</td>
+    <td colspan=2 class="PRD">PRD</td>
+</tr>
+<tr>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2 class="seperate"></td>
+    <td colspan=2></td>
+</tr>
+
+</tobdy>
+</table>
+
+
+

tfs_alert.md

@@ -0,0 +1,32 @@
+### TFS 警示設定
+
+#### 個人警示
+
+1. 進入 tfs 後，按下右上角的齒輪，進入設定  
+![TFS 設定](images/tfs_alert_01.png)
+
+2. 進入設定後，選取警示  
+![TFS 警示](images/tfs_alert_02.png)
+
+3. 警示分為「工作項目」、「推送」、「提取要求」、「組建」警示四類， 點選後，可以在右方看到相關內容。  
+![TFS 警示列表](images/tfs_alert_03.png)
+
+4. 左側下方有一些常用範本可以直接選擇  
+![TFS 警示範本](images/tfs_alert_04.png)
+
+5. 或是建立其它的警示  
+![TFS 空白警示](images/tfs_alert_05.png)
+
+6. 進入其它警示後，會有全部的警示列表，依照所需的警示內容選取，即可完成設定。  
+![TFS 警示列表](images/tfs_alert_06.png) 
+
+7. 新增後，可以進入調整警示的篩選條件  
+![TFS 警示篩選](images/tfs_alert_07.png)
+
+
+#### 小組警示
+除了可以依個人需求建立警示，也可以為小組建立警示，設定完小組警示後，小組內的成員皆可收到相關警示通知。  
+![TFS 小組警示](images/tfs_alert_08.png)  
+
+只要在設定時，將範圍選成「小組警示」，小組成員都會收到此警示。  
+![TFS 範圍](images/tfs_alert_09.png)