Code

fixes and release announcement
[roundup.git] / doc / announcement.txt
1 This is the second beta release of Roundup version 0.7. It fixes some bugs
2 in the previous beta release and introduces a few new features.
4 If you're upgrading from an older version of Roundup you *must* follow
5 the "Software Upgrade" guidelines given in the maintenance documentation.
7 No, really, this is a BETA and if you don't follow the upgrading steps,
8 particularly the bit about BACKING UP YOUR DATA, I'm NOT GOING TO BE HELD
9 RESPONSIBLE. This release is NOT FOR GENERAL USE.
11 I would *greatly* appreciate people giving this release a whirl with a
12 copy of their existing setup. It's only through real-world testing of
13 beta releases that we can ensure that older trackers will be OK.
15 Version 0.7 introduces far too many features to list here. I've put
16 together a What's New page:
18   http://roundup.sourceforge.net/doc-0.7/whatsnew-0.7.html
20 Some highlights:
22 - added postgresql backend
23 - RDBMS backends have no external locking requirements
24 - new "actor" automatic property (user who caused the last "activity")
25 - RDBMS backends have data typed columns and indexes on several columns
26 - we support confirming registration by replying to the email
27 - all HTML templating methods now automatically check for permissions,
28   greatly simplifying templates
30 Roundup requires python 2.1.3 or later for correct operation.
32 To give Roundup a try, just download (see below), unpack and run::
34     python demo.py
36 Source and documentation is available at the website:
37      http://roundup.sourceforge.net/
38 Release Info (via download page):
39      http://sourceforge.net/projects/roundup
40 Mailing lists - the place to ask questions:
41      http://sourceforge.net/mail/?group_id=31577
44 About Roundup
45 =============
47 Roundup is a simple-to-use and -install issue-tracking system with
48 command-line, web and e-mail interfaces. It is based on the winning design
49 from Ka-Ping Yee in the Software Carpentry "Track" design competition.
51 Note: Ping is not responsible for this project. The contact for this
52 project is richard@users.sourceforge.net.
54 Roundup manages a number of issues (with flexible properties such as
55 "description", "priority", and so on) and provides the ability to:
57 (a) submit new issues,
58 (b) find and edit existing issues, and
59 (c) discuss issues with other participants.
61 The system will facilitate communication among the participants by managing
62 discussions and notifying interested parties when issues are edited. One of
63 the major design goals for Roundup that it be simple to get going. Roundup
64 is therefore usable "out of the box" with any python 2.1+ installation. It
65 doesn't even need to be "installed" to be operational, though a
66 disutils-based install script is provided.
68 It comes with two issue tracker templates (a classic bug/feature tracker and
69 a minimal skeleton) and seven database back-ends (anydbm, bsddb, bsddb3,
70 sqlite, metakit, mysql and postgresql).