Project

Profile

Help

The Redmine Guide » History » Sprint/Milestone 4

Thomas Carney, 01/20/2016 05:08 AM

1 1 Thomas Carney
# The Redmine Guide
2
3
Welcome to Planio’s Redmine guide. You’ll find everything you need to unleash the power of Redmine.
4
5
First off, let’s get a quick introduction to Redmine.
6
7
## What Is Redmine?
8
9
Redmine is primarily an issue tracker. Issues, also called tickets or tasks, are the atomic unit of Redmine.
10
11
An issue tracker is a to-do list on steroids. It’s focused on accountability and forward progress.
12
13
Redmine is also includes project management aspects. You can plan out milestones on Gantt charts. You can also use Agile project management techniques such as Scrum or Kanban.
14
15
## Who Uses Redmine?
16
17
Hundreds of thousands of companies worldwide use Redmine.
18
19 2 Thomas Carney
### Open Source Projects
20
21 1 Thomas Carney
You’ll find that open source projects often use Redmine as a way to organize the project. The Ruby programming language is one very high profile project that uses Redmine.
22
23 2 Thomas Carney
### Universities
24
25 1 Thomas Carney
Redmine is a favourite for universities as a way of letting students and researchers organize their projects. Examples include X university, which organizes Z projects.
26
27
Redmine lets you make certain aspects of your projects public, while keeping others private, which is great for universities that want to involve the public in research projects.
28
29 2 Thomas Carney
### Startups
30
31 1 Thomas Carney
It’s very chaotic trying to start a business out of nothing. That’s why many startups use Redmine to organize their efforts. Redmine is a good choice because you can use it to handle software development and you can also handle incoming customer support tickets.
32
33 2 Thomas Carney
### Software Developers
34
35 1 Thomas Carney
Redmine is uniquely suited for software development. It’s highly integrated with git and svn. The wiki is often used to document software projects.
36
37 2 Thomas Carney
### Consultants
38
39 1 Thomas Carney
Redmine and email work well together, so you can include clients on projects. That improves how you work together.
40
41
## Why Do People Use Redmine?
42
43 2 Thomas Carney
### Get in Control
44
45 1 Thomas Carney
To-do lists get out of hand, and they’re hard to share with others. Issue tracking in Redmine brings teamwork to to-do lists. Redmine lets you have a powerful workflow for getting tasks done and reviewing work. You can discuss problems and find solutions with others.
46
47 2 Thomas Carney
### Keep Information in One Place
48
49 1 Thomas Carney
The wiki lets you create documentation for software, work practices and more. You can store important files in one place.
50
51 2 Thomas Carney
### Collaborate Through Discussion
52
53 1 Thomas Carney
You have an idea? The forums let you discuss it publically with your team members. You make announcements via the blog.
54
55 2 Thomas Carney
### Accessible from Anywhere
56
57 1 Thomas Carney
Redmine is accessible anywhere you have an internet connection.
58
59 2 Thomas Carney
## Who Makes Redmine?
60
61 1 Thomas Carney
Jean-Philippe Lang released the first version of Redmine in 2006. Since then, a community of open-source developers have expanded and improved upon Redmine.
62
63
Open source means you can download, use and re-write the source code. If you see something that is broken, you can contribute a fix or patch to solve the problem.
64
65
All of the developers at Planio have contributed to the Redmine core.
66 2 Thomas Carney
67
## Issue Tracking
68
69
### The Elements of a Redmine Issue
70
71
Issues are the atomic element of any Redmine account. You need to create a project before you can create issues, because every issue is connected to one project.
72
73
For example, at Planio we have separate projects for English Support tickets and German support tickets. We also have projects for different areas such as marketing and the Planio website.
74
75 4 Thomas Carney
Let’s create a new issue:
76
77
![](create-an-issue.gif)
78 3 Thomas Carney
79
### Updating Issues
80
81
As you progress through a task, you can update the issue with the latest status. You can also re-assign it to someone else and you can add notes with questions or ideas. You can also upload files as attachments.
82
83
### Creating Issues from Email
84
85
You’re walking around town, getting things done. You realize that you didn’t add the new office party as a task in Redmine.
86
87
No problem. You can quickly email your project dropbox with some details, and an issue will be automatically created in Redmine.
88
89
h2 .How do You Use Issues?
90
91
### Tasks
92
93
You have a task to get done? Create an issue and assign it yourself. Once you’ve done your part, you can assign the task to someone else for review or finishing.
94
95
**How to Use Redmine for tasks:**
96
97
You can the “Task” tracker, which is the default tracker. Trackers are just different types of issues. By default, Redmine comes with 3 different trackers. If you don’t know what you should choose, “Task” is good choice.
98
99
~~~
100
You can tell the person you’re assigning the task so information such as the priority (high, normal or low), and you can set a due date. 
101
~~~
102
103
Setting a start date and a due date means you’ll be able to visualize the task on the Gantt chart. The person the task is assigned to will also get email updates if the task isn’t completed on time.
104
105
The category field lets you group similar tasks together, which can be handy for finding and reviewing later.
106
107
Finally, you can add the task to a particular sprint or milestone, which is a good idea if you want to use Redmine’s project management functions.
108
109
### Ideas
110
111
You have an idea? You can quickly store in Redmine as an issue. You just click on create an issue, give it a subject line and then describe your idea in the description.
112
113
Often, you’d like other people to get updates on the issue even if they aren’t assigned the issue. For example, you want them to hear about your amazing new idea.
114
115
Therefore, you can set them as “watchers” for that issue. They’ll get emails notifying them of any new updates on the issue.
116
117
### Bugs/Problems
118
119
Perhaps you’ve found a bug in web application. You could create an issue in the web app’s project and assign it to one of the developers. You can describe the bug, and perhaps include a screenshot as a file.
120
121
If you’re an advanced user, you might even consider creating custom fields for bug tracking. For example, you could have a custom field for the iOS or browser. That would let you quickly filter out all the bugs for a particular device or browser.
122
123
### Support Requests
124
125
You can set up Redmine, so that your users can email support@yourcompany.com and their email will show up as an issue in Redmine. This makes it easier to manage the responses.
126
127
You can also turn Redmine into a fully featured CRM & Helpdesk via plugins. At Planio, we use the CRM & Helpdesk plugin.
128
129
When the CRM & Helpdesk is activated, you’ll see extra fields in issues for the company and contact.
130
131
## The Issues List
132
133
You’ve created a bunch of issues, and you want to start to get an overview of the issues.
134
135
The issue list is your central hub for seeing the latest status in a project.
136
137
In the beginning, it will be easy to see all the issues on one page. However, as you start getting a LOT done with Redmine, the amount of issues will grow.
138
139
At Planio we have over a quarter of a million issues in our own Planio account. That’s a lot of issues!
140
141
Happily, Redmine comes with powerful ways to drill down into issues, so you can pull out only the relevant issues.
142
143
The options let you quickly pull out the information that is relevant to you.
144
145
### Custom Queries
146
147
You can save a particular filter for quick access in the future. For example, if you want to see all the new customer support issues that haven’t been assigned, you can save that as “New Customer Tickets” and you’ll be able to access it quickly in the sidebar.
148
149
## Project Management with Redmine
150
151
Redmine offers much than just issue tracking. It also lets you track the progress of your projects, monitor how much time tasks are taking and visualize the end date.
152
153
There’s three different ways to track and manage projects in Redmine.
154
155
### The Roadmap
156
157
You can divide up your project into various milestones. You can then see how far along each chunk is. You can also dig down into which tasks are holding up reaching a particular milestone, and you can also see the time spent on the milestone.
158
159
### Gantt Chart
160
161
This will let you visualize the different aspects. An issue will only appear on the Gantt chart if you enter a start and finish date for that issue.
162
163
### Agile Project Management
164
165
This doesn’t come with Redmine core, but you can add it via plugins. A good example is Agile Plugin. We include this plugin by default at Planio. You can plan a sprint. The issues will then appear on a Kanban style board. You can drag-n-drop the issues around depending on their status.