Trac/Manual:修订间差异

来自Gea-Suan Lin's Wiki
跳到导航 跳到搜索
此页面具有访问限制。如果您看见此消息,则说明您没有权限访问此页面。
 
(未显示同一用户的32个中间版本)
第1行: 第1行:
'''Trac/Manual'''是[[Trac]]的使用手冊。
'''Trac/Manual''' 這頁 是[[Trac]]的使用手冊 ,裡面包含了Trac自己的設計,以及後來使用所累積的經驗建議


== 簡介 ==
== 簡介 ==
第20行: 第20行:


; 檢查項目
; 檢查項目
: 通常是用在有自動開票機時。通常是發生在稽核要求,或是定期檢查項目(像是UPS電池電力確認)。
: 通常是用在有自動開票機時。 通常是發生在稽核要求,或是定期檢查項目(像是UPS電池電力確認)。
; 把事情拆細
; 把事情拆細
: 母票事情太大張不知道從合作起時,通常我們會把事情拆細,然後每件小事情都開成子票。
: 母票事情太大張不知道從合作起時,通常我們會把事情拆細,然後每件小事情都開成子票。
第36行: 第36行:
[[Image:Trac-Report-My-Tickets.png|thumb|right|400px|My Tickets]]
[[Image:Trac-Report-My-Tickets.png|thumb|right|400px|My Tickets]]


 最常用的功能應該是看掛在自己身上的票(通常是在內建的Report 7,或是看各組織另外設定的Report),我通常會依據不同的狀態表示進度:
 最常用的功能應該是看掛在自己身上的票(通常是在內建的Report 7,或是看各組織另外設定的Report), 並且依照到期時間(Due Date)排序。
 
我通常會依據不同的狀態表示進度:


* 把要做的事情搬到Accepted(內建)或是Started(需要系統底層另外設定)。
* 把要做的事情搬到Accepted(內建)或是Started(需要系統底層另外設定)。
第45行: 第47行:
 在Report表格最上方的Ticket、Summary、Component、Priority、Due都是可以按的(表示希望依照這些欄位排序),當然,用Ctrl-F(或是Cmd-F)還是可以針對這些表格內容搜尋。
 在Report表格最上方的Ticket、Summary、Component、Priority、Due都是可以按的(表示希望依照這些欄位排序),當然,用Ctrl-F(或是Cmd-F)還是可以針對這些表格內容搜尋。


 另外我會在系統底層會設定一些跟到期日 (Due Date) 有關的樣式 ,其中 有框線的是今天到期的票 ,而 粗體為超過到期日的票。
 另外我會在系統底層會設定一些跟到期日有關的樣式
 
有框線的是今天到期的票
粗體為超過到期日的票
 
這些可以幫助使用者快速了解目前的狀況


== 開票操作 ==
== 開票操作 ==
[[Image:Trac-New-Ticket.png|thumb|right|400px|New Ticket]]
通常遇到任何狀況(甚至是已經解決了),我們都會開一張票記錄追蹤,讓事情留下記錄。
Trac的開票在系統上只有限制Summary一定要填寫,其他的沒有強制規定。一般來說,在組織裡面會另外要求以下的行為:
* 一定要指定給一個人,這樣才能後續追蹤。
也有可能會有其他的要求:
* 設定可能的Due Date(通常開票時不一定知道精準的Due Date,可以再改)。
* 設定合理的Component(因為每個Component會自動Cc給對應的負責人,或是負責的一群人)。
要注意的是,不需要擔心重複開票,如果真的發生了只需要在票上記錄跟哪張重複,再關掉其中一張就好了(通常留下資訊比較完整的的那張,或是比較先開的那張)。
== 關票操作 ==
當這張票不需要再被追蹤時我們會把票關掉,而關票需要注意以下事情:
* 讓「開票」的人關票。如果你不是開票人,把票轉回(reassign)給開票人讓他關。
** 這樣的好處是讓開票人可以確認內容是否正確(而通常開票的需求人對需求的了解是最完整的)。
* 關票可以選擇關閉的狀態,常用的有:
** <code>fixed</code>:票上的事情做完搞定。
** <code>wontfix</code>:票上的事情合理,但不打算做。
** <code>invalid</code>:票上的事情不合理,所以不打算做。
** <code>duplicate</code>:票上的事情跟其他票重複了,通常我們會在留言的地方描述跟哪張重複。
* 雖然Trac內建有<code>worksforme</code>可以選,但這個選項常常會拿掉(因為其實是很攻擊性的選項,會給人有種「我懶得管你」的感覺)。
== 子母票與專案管理 ==
[[Image:Trac-Subtickets.png|right|thumb|400px|有子票的票]]
子母票可以建立票的相依性,讓使用者可以有階層式的概念把大票拆細。對一個專案來說,這個作法可以讓專案管理者有全局性的概念,了解目前執行的情況。
使用子母票時需要注意這些事情:
* 一張母票可以開很多子票(這個比較好理解),一張子票也可以開很多母票。
** 把票號用逗號隔開就可以了(像是<code>1,2,3</code>這樣)。
** 同一張票可以掛到很多母票上這點可以善用在很多地方,像是一張實做的票可以掛在「部門2018年執行項目」的母票,以及「XX專案」下,對於不同單位來說有不同追蹤的方法。
* 子票還可以再開子票(孫票?),不受限只有一層。
** 這樣彈性會比較大,舉例來說,一個大型專案的設計相關部份可以掛到某個部門主管身上,再由那個單位拆給部門內的各個設計師實做,這樣追蹤也比較清楚。
* 系統會阻擋loop行為。
** 像是自己掛自己為母票,或是把母票掛到子票上。
* 系統會阻擋關票行為。
** 當子票沒關時,母票是不能關的。
最後可以說,子母票的用法不受限於上面所說的項目,Trac只是一個工具,如果有其他用法可以幫助到你自己就可以用用看(當然,前提是不會造成別人爆炸)。


== 相關連結 ==
== 相關連結 ==
* [[Trac]]
* [[Trac]]

2018年4月30日 (一) 06:56的最新版本

Trac/Manual这页是Trac的使用手册,里面包含了Trac自己的设计,以及后来使用所累积的经验建议。

简介

Trac是一套Issue Tracking System(问题追踪系统),任何的“问题”都会在系统内开一张Ticket(票),借由软件系统帮助使用者(通常是员工)追踪问题。

常见追踪项目

最常见的几种开票项目:

Bug
软件的bug,或是网站功能的bug。
Feature
通常是开发新功能。
Enhancement
通常是改善既有功能。

其他项目

另外有些事情也会开票:

检查项目
通常是用在有自动开票机时。这通常是发生在稽核要求,或是定期检查项目(像是UPS电池电力确认)。
把事情拆细
母票事情太大张不知道从合作起时,通常我们会把事情拆细,然后每件小事情都开成子票。

基本概念

用Trac有一些基本概念要注意:

票的Owner就是负责人
被指派到就是负责人,没有理由卸责。如果这张票不是属于自己业务范围就应该要转回去(转回给上一个人,或是转回给开票人)。
开票的人(Reporter)负责关票
开票的人通常是最清楚知道开这张Ticket需要处理的项目,由他来关票可以确保问题有被解决。

常用功能

My Tickets

My Tickets

最常用的功能应该是看挂在自己身上的票(通常是在内建的Report 7,或是看各组织另外设定的Report),并且依照到期时间(Due Date)排序。

我通常会依据不同的状态表示进度:

  • 把要做的事情搬到Accepted(内建)或是Started(需要系统底层另外设定)。
  • 其他的事情放在Assigned或是Others。

这个模式可以让其他人知道你目前正在处理那些票。

在Report表格最上方的Ticket、Summary、Component、Priority、Due都是可以按的(表示希望依照这些字段排序),当然,用Ctrl-F(或是Cmd-F)还是可以针对这些表格内容搜寻。

另外我会在系统底层会设定一些跟到期日有关的样式:

  • 有框线的是今天到期的票。
  • 粗体为超过到期日的票。

这些可以帮助使用者快速了解目前的状况。

开票操作

New Ticket

通常遇到任何状况(甚至是已经解决了),我们都会开一张票记录追踪,让事情留下记录。

Trac的开票在系统上只有限制Summary一定要填写,其他的没有强制规定。一般来说,在组织里面会另外要求以下的行为:

  • 一定要指定给一个人,这样才能后续追踪。

也有可能会有其他的要求:

  • 设定可能的Due Date(通常开票时不一定知道精准的Due Date,可以再改)。
  • 设定合理的Component(因为每个Component会自动Cc给对应的负责人,或是负责的一群人)。

要注意的是,不需要担心重复开票,如果真的发生了只需要在票上记录跟哪张重复,再关掉其中一张就好了(通常留下资讯比较完整的的那张,或是比较先开的那张)。

关票操作

当这张票不需要再被追踪时我们会把票关掉,而关票需要注意以下事情:

  • 让“开票”的人关票。如果你不是开票人,把票转回(reassign)给开票人让他关。
    • 这样的好处是让开票人可以确认内容是否正确(而通常开票的需求人对需求的了解是最完整的)。
  • 关票可以选择关闭的状态,常用的有:
    • fixed:票上的事情做完搞定。
    • wontfix:票上的事情合理,但不打算做。
    • invalid:票上的事情不合理,所以不打算做。
    • duplicate:票上的事情跟其他票重复了,通常我们会在留言的地方描述跟哪张重复。
  • 虽然Trac内建有worksforme可以选,但这个选项常常会拿掉(因为其实是很攻击性的选项,会给人有种“我懒得管你”的感觉)。

子母票与专案管理

有子票的票

子母票可以建立票的相依性,让使用者可以有阶层式的概念把大票拆细。对一个专案来说,这个作法可以让专案管理者有全局性的概念,了解目前执行的情况。

使用子母票时需要注意这些事情:

  • 一张母票可以开很多子票(这个比较好理解),一张子票也可以开很多母票。
    • 把票号用逗号隔开就可以了(像是1,2,3这样)。
    • 同一张票可以挂到很多母票上这点可以善用在很多地方,像是一张实做的票可以挂在“部门2018年执行项目”的母票,以及“XX专案”下,对于不同单位来说有不同追踪的方法。
  • 子票还可以再开子票(孙票?),不受限只有一层。
    • 这样弹性会比较大,举例来说,一个大型专案的设计相关部分可以挂到某个部门主管身上,再由那个单位拆给部门内的各个设计师实做,这样追踪也比较清楚。
  • 系统会阻挡loop行为。
    • 像是自己挂自己为母票,或是把母票挂到子票上。
  • 系统会阻挡关票行为。
    • 当子票没关时,母票是不能关的。

最后可以说,子母票的用法不受限于上面所说的项目,Trac只是一个工具,如果有其他用法可以帮助到你自己就可以用用看(当然,前提是不会造成别人爆炸)。

相关连结