Redmine provides the following modules per Project
Issue management & time tracking (via tickets)
Wikis (1 per project)
Forums (can create multiple forums per project)
Subversion repositories (1 per project)
Mailing lists (1 per project)
Recommended setup & usage
We recommend the following usage:
Use the issues tracker to create issues, tasks, milestones and
deadlines for your project, and assign it to your team members.
Think of issues as "tickets" they allow you to plan tasks and future
features, as well as to be used for bug tracking.
The mailing list is the preferred way of communication, but you can
also use forums.
Use subversion (SVN) or Git for all kinds of files requiring version
management: HDL and software/firmware, schematics, PCB layout,
manufacturing files, etc.
Use the Documents module for providing "release" versions of
Documents; Typically you would show versions 1.0, 2.0 and 3.0 on the
Documents section, and all the intermediate steps (1.1, 2.3.1, etc)
would be managed via the SVN.
Similarly, use the Files section for "release" versions of important
files, such as binary installation programs, drivers, schematics,
gerber files, firmware etc. Again, intermediate versions of these
should be managed via subversion.
Use the wiki for storing the information you want to conserve about
your project, but for which you don't have specific documents;
meeting minutes, informal, high-level descriptions, objectives, etc.
Also, the wiki is the entry place for most people into the project,
so it's good to have a quick intro and a status table in it. Here's
an example (sample source
code at attachment:spec_wiki.txt).
Use the News section for publishing important events, such as a new
exposition or review meeting.
One alternative to the use of the Documents and Files modules is to have
a dedicated documentation wiki page with links to important files in the
SVN repository. This has the advantage of not duplicating files and the
disadvantage of a (potentially) less intuitive navigation experience for
the occasional visitor.
Adding new users
New users should apply for an account with the
Register link (top-right of the
screen). They will have to be approved by an administrator (Javier).
If you are not an administrator and need to create lots of new users,
please open a
ohr-support. You will need to specify the user names and email addresses
there - an attached text file is recommended.
Once approved, users can be given roles on a project via the project's
Settings / Members tab by a project manager.
When a project manager adds a user, he has to set the Role. These are
the current Roles in ohwr:
Administrator - can do everything
Manager (of a project) - can do everything, but only in a
Developer (of a project) - like manager, except: manage
documents, create forums, manage wiki pages and manage news.
Reporter (of a project) - Only able to create new issues and
read-only rights on the rest.
If you only want to browse the source code, notice that Redmine provides
a nicer interface via its "Repository" tab (you should see it on the
toolbar, above this text). It is also possible to include links to
particular releases or files (see the "wiki editing
guide"/help/wiki_syntax_detailed.html for details).
Mailing Lists (Sympa)
If you have requested it, your project will include a mailing list.
Mailing lists are managed via a sympa
From there, you can browse the mailing list's archive, list of users,
Mailing list archives are publicly available. There's no way to make
private mailing lists.
If you are a project's manager, an account will be created for you on
the sympa system. Your login and password will be the same as you use on
the ohwr site. You will have owner rights over that list.
Appart from that, sympa's subscriptions are separated and independent
from the rest of ohwr's accounts; It's possible to be a member of a
project, and not be subscribed to its mailing list (in fact, newly
created users are NOT automatically subscribed to the project's mailing
list; they have to proactively subscribe - see below). It's also
possible to be subscribed to a sympa mailing list while not having a
project account (this is useful for external mail-only collaborators).
There isn't any procedure for automatically subscribing new project
users to a mailing lists; only list owners are created automatically
from project managers. The sympa web interface provides the lists owners
with a way to mass-subscribe lots of users via uploading of a text file.
We however recommend keeping the subscription voluntary.
Mailing lists are open; anyone can send an email to them, including
unregistered users. Emails from unregistered users will be moderated by
the mailing list owners (they will receive a private email when an email
from an unregistered user arrives).
In order to make a full server backup, you may download the Rakefile
from our repository link
Please read its comments and configure it properly before using it.