Hi Roger,
I'm quoting an old email as this is the only place I can find a
summary of what the issue tracker integration is for. The contrib
folder details how to write the COM object, and I have no intention of
documenting that in the help file. I'm assuming a friendly admin will
have written the COM object and issue tracker end, and supplied a
working hook to members of the dev team, who then plug it into TSVN.
That's not an everyday job for TSVN users, so the contrib folder is
the right place for that description.
What I need is the user perspective: what does this do, how do I
install the plugin, what does it look like once I have done that.
Normally I would just try using it myself, but in this case I do not
have a COM object to test, so I'm a bit stuck.
I have a reasonable picture of what you are doing from this:
2008/4/22 Roger Lipscombe <roger_at_differentpla.net>:
>
> The user story I'm attempting to solve here is this one:
>
> 1. Marvin the manager assigns a ticket or task to Dave, the developer, using
> the issue-tracking or task-management software (we use TargetProcess, I use
> Trac for my personal projects).
> 2. Dave looks at his list of tasks using the issue-tracking software's front
> end (i.e. a web-dashboard). He picks something to work on this morning.
> 3. Dave fires up Visual Studio; hacks on some code; does some work toward
> the task.
> 4. Dave brings up TSVN's commit dialog. He types in a comment that lists:
> a) The ticket/task number of what he's been working on.
> b) Some comments about what he's changed.
> c) How long he's spent working on the task.
> d) How long he thinks is remaining.
> 5. He clicks OK, and his changes are committed to the repository.
> 6. TargetProcess monitors the SVN repository, watching for commits. It sees
> Dave's commit message, extracts the information from it, and updates the
> task, by adding "time" to it.
> 7. Marvin looks in TargetProcess, and can monitor the project's progress.
>
> As it stands, TSVN supports (most of) this admirably. For example, with the
> Trac integration, I can put "See #43" or "Fixes #99" somewhere in the commit
> message, and Trac's post-commit hook will update the tickets accordingly.
>
> However:
> 1. Dave has to keep the issue-tracker front-end open in order to look up the
> ticket numbers.
> 2. Some issue trackers want more information (e.g. time spent, time
> remaining), and it needs to be formatted more rigidly. For example,
> TargetProcess wants something like (from memory): "task:66 spent:3
> remaining:2 comment:Move strings to resource files"
>
> So, the requirement is this:
>
> From the TSVN commit dialog, the user should be able to display up a list of
> assigned tickets from the issue-tracker associated with that repository. The
> user should be able to pick one or more tasks from this list. This will
> populate the commit message with the information required by the
> issue-tracker's SVN server-side post-commit hook.
So, putting my user hat on, once I have installed the plugin, I find a
new hyperlink on my commit dialog (where?). I click on the link and
the plugin starts up, typically to contact the tracker and display a
list of open issues. I select an issue and the plugin closes the
dialog and modifies the current log message in some way (typically
appends a formatted string to it, based on the issue I have selected).
The part that is least clear is installation/setup. I can't find how
you install the plugin, nor what settings are required on the
TSVN->Settings page.
I also need some screenshots. If I can install a pre-built example
plugin (like your contrib ones) then I can test this and grab the pics
myself, but I don't have a C++/C# build environment (I'm not a Windows
programmer) so I can't just build the contrib one myself. Maybe it
would be worth including the example as a download from the nightly
site, so others can try it out.
Simon
--
: ___
: oo // \\ "De Chelonian Mobile"
: (_,\/ \_/ \ TortoiseSVN
: \ \_/_\_/> The coolest Interface to (Sub)Version Control
: /_/ \_\ http://tortoisesvn.net
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe_at_tortoisesvn.tigris.org
For additional commands, e-mail: dev-help_at_tortoisesvn.tigris.org
Received on 2008-05-15 01:07:02 CEST