Project

General

Profile

How to use ctt » History » Revision 7

Revision 6 (Sanghee Kim, 02/01/2020 11:00 PM) → Revision 7/11 (Sanghee Kim, 02/01/2020 11:02 PM)

h1. How to use ctt 

 h2. General Ticket handling 

 * Tickets which are not in progress for the moment needs to be set as unassigned & seen 
 * New Tickets, should be unassigned & new 
 ** these tickets need to be watched and changed in 1 day 

 h2. Introduction 

 * Installation of "ctt":https://code.ungleich.ch/ungleich-public/ctt.git (or compatible) (*[[for windows user]]) 
 ** clone the repository to a location you whish 
 <pre> 
 git clone https://code.ungleich.ch/ungleich-public/ctt.git ~/Work/bin/ctt 
 </pre> 
 ** Edit your PATH environment variable 
 *** e.g. open your ~/.bashrc and append 
 <pre> 
 export PATH=$PATH:~/Work/bin/ctt/bin 
 </pre> 
 *** source your ~/.bashrc 
 <pre> 
 source ~/.bashrc 
 </pre> 
 ** if you run "ctt" now you should see the usage of it 
 * *Send Dominique your ssh key, otherwise the next steps won't work* 
 * Clone the dot-ctt repository from git@code.ungleich.ch:ungleich/dot-ctt.git 
 <pre> 
 git clone git@code.ungleich.ch:ungleich/dot-ctt.git ~/.ctt 
 </pre> 
 * Track your time to "$customer-$yourname" (ctt track $customer-$yourname <ENTER>) for instance 
 ** ungleich-$YOURNAME 
 ** customer1-$YOURNAME 
 ** customer2-$YOURNAME 
 * When you finished working, press <ENTER> once again then give a comment what you worked on (See details below) 
 * All times need to be pushed every friday 
 <pre> 
 cd ~/.ctt 
 git pull 
 git add ./* 
 git commit -m "added times" 
 git push 
 </pre> 
 * If working for a customer of a customer, include the customer/project name: 
 ** IDENTIFIER; normal text 
 * When working on a *fixed budget* project for a customer, book the hours to ungleich 
 * If you are working at/for ungleich, your ctt entries will be reviewed, and logs not meeting the following criteria can/will be rejected. 
 ** Time tracking *should not exceed 180 minutes* for one session of work 
 *** ** Write a good and concise description of the work done per entry. 
 *** ** Show the your transparent progress of your task in the description. 
 *** ** If working on the same task for a long period of time, break it down in session description: avoid giving the same, repeated description for many entries happened over extensive hours.  

  
 ** If you are working at/for ungleich, your ctt entries will be reviewed, and logs not meeting the above criteria can/will be rejected. 

 h3. Deleting tracked time entry 

 <pre> 
 rm -r ~/.ctt/$customer-$yourname/YYYY-MM-DD-HHmm 
 </pre> 

 Where YYYY-MM-DD-HHmm is the start time of your tracked entry. 

 e.g. 

 <pre> 
 rm -r ~/.ctt/ungleich-intern-user/2015-08-26-2030 
 </pre> 


 h3. Change the comment 

 The comment is stored in the following file: 

 <pre> 
 ~/.ctt/$customer-$yourname/YYYY-MM-DD-HHmm/comment 
 </pre> 

 Just open this file with a text editor (e.g. vim, nano, Notepad++ etc. (NOT WORD)) and change it's content 

 h2. Times & Dates 

 * Enter times until friday every week (everybody) 
 * Verify time entries until sunday evening (Nico) 
 * Transfer times to customer systems until monday midday (David) 

 h2. Some time-entry examples 

 * You work for a Ticket of Customer 

 <pre> 
 ctt track customer-$YOURNAME 
 Comment = Customer; #TICKETNUMBER; Comment 
 </pre> 

 * You work internal hours 

 <pre> 
 ctt track ungleich-$YOURNAME 
 comment = Ungleich; (#TICKETNUMBER); Comment 
 </pre> 

 * You work on fix price Project of Customer 

 <pre> 
 ctt track ungleich-customer-$YOURNAME 
 comment = Customer; (#TICKETNUMBER); Comment 
 </pre> 

 * You worked on a project but forgot to track: 

 <pre> 
 ctt track ungleich-intern-$YOURNAME --sd YYYY-MM-DD-HHMM --ed YYYY-MM-DD-HHMM 
 comment = COMMENT 
 </pre> 
 You can leave the --ed part if you still working on it now 

 h2 Reporting your time 

 <pre> 
 cd .ctt 
 ctt report *${YOURNAME} 
 </pre>