Code

pre-release stuff
[roundup.git] / doc / announcement.txt
index 8bf1675b9cbcde246870a6c33bace67a2ff551f7..21331c728054f3c6b2256d15a723d41a8463cbc0 100644 (file)
@@ -1,46 +1,39 @@
-=====================================================
-SC-Track Roundup 0.5 beta1 - an issue tracking system
-=====================================================
-
-Note: This is the first of two beta releases of the newest version of Roundup.
-It is strongly recommended that you maintain your existing 0.4 installation if
-you have one, and run 0.5 on a copy of the database. If you are upgrading from
-0.4, you must read doc/upgrading.txt!
-
-Roundup requires python 2.1.1 for correct operation. Support for dumbdbm
-requires python 2.1.2 or 2.2. 2.1.3 and 2.2.1 are recommended.
-
-A lot has been done since 0.4:
-
-- new backend for metakit (thanks Gordon McMillan)
-- new backend for gadfly (it's as done as it's going to get)
-- further split the *dbm backends from the core code, allowing easier
-  non-dict-like backends (eg metakit, RDB)
-- implemented and used the new access control mechanisms (Permissions, Roles)
-- switched templating to use Zope's PageTemplates (yay!)
-- switched to sessions for web authentication
-- added Boolean and Number types
-- full-text search may also search certain String properties
-- fixed the journal bloat
-- updated design document for new access controls
-- updated customisation document, including more examples
-- entire database export and import (incl files)
-- better mailgw help message (feature request #558562)
-- re-enabled link backrefs from messages (feature request #568714)
-- the page layout is now templatable
-- re-worked cgi interface to abstract out the explicit "issue" interface
-- have index page handle mid-page errors better so header and footer are
-  still visible
-- saving of named search queries
-- we handle "not found", access and item page render errors better
-- fixed double-submit by having new-item-submit redirect at end
-- daemonify roundup-server (fork, logfile, pidfile)
-- modify cgitb to display PageTemplate errors better
-- rename to "instance" to "tracker"
-- have roundup.cgi pick up tracker config from the environment 
-- revamped look and feel in web interface
-- cleaned up stylesheet usage
-- several bug fixes and documentation fixes
+It is with a huge sigh of relief that I announce this first beta of
+Roundup version 0.7.
+
+If you're upgrading from an older version of Roundup you *must* follow
+the "Software Upgrade" guidelines given in the maintenance documentation.
+
+No, really, this is a BETA and if you don't follow the upgrading steps,
+particularly the bit about BACKING UP YOUR DATA, I'm NOT GOING TO BE HELD
+RESPONSIBLE. This release is NOT FOR GENERAL USE.
+
+I would *greatly* appreciate people giving this release a whirl with a
+copy of their existing setup. It's only through real-world testing of
+beta releases that we can ensure that older trackers will be OK.
+
+This release introduces far too many features to list here. Some
+highlights:
+
+- added postgresql backend (originally from sf patch 761740, many changes
+  since)
+- RDBMS backends implement their session and one-time-key stores and
+  full-text indexers; thus they are now performing their own locking
+  internally
+- added new "actor" automatic property (indicates user who cause the last
+  "activity")
+- all RDBMS backends have sensible data typed columns and indexes on
+  several columns
+- we support confirming registration by replying to the email (sf bug
+  763668)
+- all HTML templating methods now automatically check for permissions
+  (either view or edit as appropriate), greatly simplifying templates
+
+Roundup requires python 2.1.3 or later for correct operation.
+
+To give Roundup a try, just download (see below), unpack and run::
+
+    python demo.py
 
 Source and documentation is available at the website:
      http://roundup.sourceforge.net/
@@ -53,14 +46,14 @@ Mailing lists - the place to ask questions:
 About Roundup
 =============
 
-Roundup is a simple-to-use and -install issue-tracking system with 
-command-line, web and e-mail interfaces. It is based on the winning design 
+Roundup is a simple-to-use and -install issue-tracking system with
+command-line, web and e-mail interfaces. It is based on the winning design
 from Ka-Ping Yee in the Software Carpentry "Track" design competition.
 
-Note: Ping is not responsible for this project. The contact for this project 
-is richard@users.sourceforge.net.
+Note: Ping is not responsible for this project. The contact for this
+project is richard@users.sourceforge.net.
 
-Roundup manages a number of issues (with flexible properties such as 
+Roundup manages a number of issues (with flexible properties such as
 "description", "priority", and so on) and provides the ability to:
 
 (a) submit new issues,
@@ -75,6 +68,6 @@ doesn't even need to be "installed" to be operational, though a
 disutils-based install script is provided.
 
 It comes with two issue tracker templates (a classic bug/feature tracker and
-a help desk) and five database back-ends (anydbm, bsddb, bsddb3, metakit and
-gadfly). 
+a minimal skeleton) and seven database back-ends (anydbm, bsddb, bsddb3,
+sqlite, metakit, mysql and postgresql).