Effective programming practices for economists. 9. More on teamwork with Redmine

Transcription

1 Effective programming practices for economists 9. More on teamwork with Redmine Hans-Martin von Gaudecker Department of Economics, Universität Mannheim Licensed under the Creative Commons Attribution License 1/22

2 Redmine features Online repository browser is only one feature... We ll look at the issue tracker in the rest of this lecture. And a bit at Gantt charts. Other features: Activity List activity in the project great to see what has happened last. News Announcements. Forums Discuss and document posts. Wiki Useful place for project description, ways forward, etc.. alternative to such a document among the source files. Documents Upload documents. Files Upload files. Time track. Useful for some third party funded projects. Clean up the menu bar by unchecking functionality in Settings Modules Licensed under the Creative Commons Attribution License 2/22

3 The issue tracker Often called bug tracker, since it was originally designed to document software errors. Find an error, report it to the tracker. Assign it to somebody, gather more data, find a strategy to fix it. Fix it and report it as closed. But it really is a shared to-do list. Same workflow for new software features (here: model features... ). Backbone of software development portals like sourceforge.net, bugzilla, etc.. Licensed under the Creative Commons Attribution License 3/22

4 Creating a new issue Licensed under the Creative Commons Attribution License 4/22

5 Creating a new issue Licensed under the Creative Commons Attribution License 5/22

6 Creating a new issue Licensed under the Creative Commons Attribution License 6/22

7 Updating an issue Licensed under the Creative Commons Attribution License 7/22

8 Updating an issue Licensed under the Creative Commons Attribution License 8/22

9 Updating an issue Licensed under the Creative Commons Attribution License 9/22

10 Listing all issues Licensed under the Creative Commons Attribution License 10/22

11 You could change the status manually... Click on update again, pick one of... New Nobody is working on it. In Progress Someone s taking care of it. Closed Somebody took care of it, no more relevant. Rejected It was a false alarm of some kind, does not apply anymore, feature not wanted after all, etc.. Licensed under the Creative Commons Attribution License 11/22

12 ... or close it with the commit message Syntax: (fixes closes) #ID, where ID is the issue identifier (note they are site-wide, so don t be surprised by high numbers.) Licensed under the Creative Commons Attribution License 12/22

13 ... or close it with the commit message Licensed under the Creative Commons Attribution License 13/22

14 ... or close it with the commit message Licensed under the Creative Commons Attribution License 14/22

15 ... or close it with the commit message Licensed under the Creative Commons Attribution License 15/22

16 Recommended workflow Always put the next steps you need to take as enhancementes into the issue tracker. Paper you need to cite, code you need to write,... Try to be relatively fine-grained, but you ll have to find out the optimal content quantity for yourself. When you come back to the project, first look through the issues. Even after two days. Amazing with how many ideas I come up twice... Try to put any non-trivial bug or strange-looking behaviour into the tracker. Especially if you cannot fix it immediately. Just writing down the description often helps. Useful information later on many bugs pop up in different disguises later on. Use it even when you re by yourself. Licensed under the Creative Commons Attribution License 16/22

17 Gantt charts Illustrate project schedule what task you plan to do when. Useful when you are in a hot phase of a project. Clear deadlines are a prerequisite. If this is so, use both start/end dates in issue description. Gantt chart filled up automatically. Licensed under the Creative Commons Attribution License 17/22

18 Gantt charts Licensed under the Creative Commons Attribution License 18/22

19 Gantt charts Effective Programming F S S M T W T F S S M T W T F S S M T W T F S S M T W T F S S New 60% Feature 14: Grade exercises Feature 11: RegEx operators and patterns. New 30% Feature 10: Finish slides for Redmine lecture. New 0% Feature 12: RegEx finite state machine. New 0% Feature 8: Read relevant parts of Arbuckle10 New 0% Feature 9: Slides for first example on testing New 0% Feature 15: Finish slides for testing. New 0% Feature 16: Come up with homework on testing. New 0% Licensed under the Creative Commons Attribution License 19/22

20 News / Discussion Use these instead of s wherever you can. Documentation in a central place is a major advantage. You find stuff easier when you need it. News for announcements. Forums for discussions. Licensed under the Creative Commons Attribution License 20/22

21 Acknowledgements and revision number This course is designed after and borrows a lot from the Software Carpentry course designed by Greg Wilson for scientists and engineers. The Software Carpentry course material is made available under a Creative Commons Attribution License, as is this course s material. Last changed revision: 281 Last changed date: :43: (Mon, 06 Dec 2010) Licensed under the Creative Commons Attribution License 21/22

22 License for the course material [Links to the full legal text and the source text for this page.] You are free: to Share to copy, distribute and transmit the work to Remix to adapt the work Under the following conditions: Attribution You must attribute the work in the manner specified by the author or licensor (but not in any way that suggests that they endorse you or your use of the work). With the understanding that: Waiver Any of the above conditions can be waived if you get permission from the copyright holder. Public Domain Where the work or any of its elements is in the public domain under applicable law, that status is in no way affected by the license. Other Rights In no way are any of the following rights affected by the license: Your fair dealing or fair use rights, or other applicable copyright exceptions and limitations; The author s moral rights; Rights other persons may have either in the work itself or in how the work is used, such as publicity or privacy rights. Notice For any reuse or distribution, you must make clear to others the license terms of this work. The best way to do this is with a link to this web page.