Os Khera

Using Trac Efﬁciently Work Smarter, Not Harder Vivek Khera, Ph.D. MailerMailer LLC

The Problem Handful of developers No “real” management layer Many projects Many customers

The Old Way Email or IM requests Pen and paper notes Private to-do lists

The New Way Create task; notify by email Electronic notes To-do lists prioritized and visible by all

Basics of Trac Ticketing Subversion Integration Wiki

Conﬁgure Trac

Role-based permissions Toss out default permissions set Deﬁne roles such as “admin”, “user” Real users given roles

Sample Permissions BROWSER_VIEW CHANGESET_VIEW CONFIG_VIEW FILE_VIEW LOG_VIEW MILESTONE_ADMIN REPORT_ADMIN Admin ROADMAP_ADMIN SEARCH_VIEW TICKET_ADMIN TIMELINE_VIEW TRAC_ADMIN WIKI_ADMIN BROWSER_VIEW CHANGESET_VIEW CONFIG_VIEW FILE_VIEW LOG_VIEW MILESTONE_ADMIN REPORT_ADMIN Developer ROADMAP_ADMIN SEARCH_VIEW TICKET_ADMIN TIMELINE_VIEW WIKI_ADMIN BROWSER_VIEW CHANGESET_VIEW FILE_VIEW MILESTONE_VIEW REPORT_VIEW ROADMAP_VIEW User SEARCH_VIEW TICKET_ADMIN WIKI_CREATE WIKI_MODIFY WIKI_VIEW

Ticketing System

Ticket Types Default list: Defect Enhancement Task Add as needed, like “text_change”

Components Examples: “parser”, “SQL”, “documents” Specify default ownership of tickets

Other Properties Severity Priority Version Keywords

Managing Tickets Break up “Big Idea” tickets into smaller steps Add notes on progress Reference ticket in subversion commit note: closes #134 references #42

Milestones Grouping of tickets Set due date Keep small enough to ﬁnish in two weeks

Send email on changes Conﬁgure mail server information Ensure every user has email address in default domain

Subversion

SVN Integration Source code browser Commit messages interpreted for links Conﬁgure subversion to send email

Subversion Hook #!/bin/sh REPOS=quot;$1quot; REV=quot;$2quot; PATH=$PATH:/usr/local/bin export PATH NOTIFY=nadine@mailermailer.com # do some magic for Trac tickets LOG=`svnlook log -r $REV $REPOS` AUTHOR=`svnlook author -r $REV $REPOS` TRAC_ENV='/web/trac/projects/nadine' TRAC_URL='http://projects/nadine' trac-post-commit-hook -p quot;$TRAC_ENVquot; -r quot;$REVquot; -u quot;$AUTHORquot; -m quot;$LOGquot; -s quot;$TRAC_URLquot; # send nicely formatted commit message. svnnotify --repos-path quot;$REPOSquot; --revision quot;$REVquot; --to quot;$NOTIFYquot; --user-domain mailermailer.com --with-diff --subject-cx --no-first-line --handler HTML --revision-url quot;$TRAC_URL/changeset/%squot;

Structuring the Wiki DesignNotes ImplementationNotes OperationNotes TestingNotes MarketingNotes WordDeﬁnitions

Extensions You Want [[BackLinks]] macro [[LastModiﬁed]] macro

Some You Might Want Wiki Goodies Footnote Not Implemented Reference Wiki Include TOC Macro

Putting it all Together Everyone must participate Do the tasks in order Enforce documentation

Resources Trac Project: http://trac.edgewall.com/ Trac Hacks: http://trac-hacks.org/

Questions Presentation available from http://labs.mailermailer.com/

Os Khera

by oscon2007 on Aug 19, 2007

Accessibility

Categories

Upload Details

Usage Rights

Statistics

Os Khera Presentation Transcript