Versions Compared

Old Version 1

changes.mady.by.user T.C. Chou

Saved on

compared with

New Version 2

changes.mady.by.user T.C. Chou

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Tip
title如何建立一個 Jira 事例
  1. 建立一個帳號在 這裡, 如果沒有的話
  2. 登入
    1. (選擇性, 如果不確定是否為新的) 搜尋一下! 使用 "找尋事例"(Find issues) 可能找到一個已存在的事例
    2. (選擇性, 如果不確定是否為新的) 假使有相彷目標的事例, 直接在上面加上你的意見
  3. 如果事例不存在, 建立新的選用 "create new issue" 項目。事例建立的細節, 請參考 這裡
  4. 選擇 OFBiz 專案和事例型態
  5. 填妥所有欄位, 寫上你認為儘可能詳細的細節
    • 通常很重要的是在 "影響版本" (Affect Version) 欄位, 選擇所執行的 OFBiz 版本。如果執行是主力版本, 那就在環境 (Environment) 欄位指定 SVN 修改的版本。
    • 環境欄位至少載明所使用的作業系統和資料庫, 這些資料對想提供協助的人是很重要
    • 選擇相關元件(可多選)。如果所有元件都被影響, 選 ALL_COMPONENTS (罕見的情況)
  6. 如果需要帶附檔, 像修補擋, 建完事例後必須進行第二步驟。可輕鬆帶截圖到事例的範例, 參考 這裡
    • 當要帶附檔或截圖, 可增加一個意見, 在說明所在就可附加檔案。請在文字中寫明檔案名稱, 因為之後的意見有可能加入更多附檔, 全都列在一起而且距原先意見有段距離
    • 也請最好使用 .patch 做為修補檔案的附檔名。如果更新檔案檔名相同的話: Jira 能夠把之前的舊檔案轉為灰色, 不用特別去刪除他們 (有時候便於和較舊的修補檔案版本做比較)
  7. Jira 提供投票機制, 讓事例的處理更恰當 (請參考 這裡 更多的資訊)
Note
title當要建立 Jira 事例
  1. 在建立任何 Jira 事例前, 請先檢查一下, 使用相關的關鍵字詞, 確認類似的事例還沒出現過。做法是先使用 Jira 頁面右上角的快速搜尋 (Quick Search), 之後可進一步調整搜尋的資料。舉例來說, 預設會搜尋全部專案, 你應該指定搜尋 OFBiz, ... 等等。
  2. 假如要提供改進或修正的修補檔案(patch), 先建立一個 Jira 事例(如果之前沒有的話), 然後把修補檔案做成事例的附檔。
  • 如果沒有修補檔案, 但發現一個 錯誤, 趕緊建一個 Jira 事例 (如果之前沒有) 儘可能提供相關細節 (包含源碼版本, 和使用環境, 以及重製錯誤的步驟)。如果不清楚如何描述, 請參用下面樣板
    1. 做了什麼 (包含重製錯誤的步驟)
    2. 期待發生什麼
    3. 實際發生什麼 (也包括確切的錯誤訊息, ... 等等)
    4. 有的話, 提供相關網址
  1. 如果沒有修補檔案, 但想要做改良或新功能的建議, 請先在開發論壇中討論, 不要直接建 Jira 事例; 在論壇中, 社群可以充份考慮, 討論出共識後再建立一個 Jira 事例, 促進 OFBiz 未來的發展。
  2. 如果沒有修補檔案, 但計劃要做的話, 想先和社群分享設計細節, 應該使用論壇來討論而不是建立 Jira 事例; 另一方面來說, 你目前沒有時間進行, 但已經決定根據特定設計細節要做修補, 相讓社群先瞭解之後的修補檔案內容, 就可以建立 Jira 事例 (之後會把修補檔案附帶進來)。
    小結:
  • 錯誤: 任何時候發現新的錯誤, 都請建立一個新的 Jira 事例
  • 新功能/改良: 如果有修補檔案, 才建立一個新的 Jira 事例 (或是計畫很快的做出來)

未完 ...