Sending out this second RFR just to make it easier to see the cumulative changes. I adopted most of CP's recent suggestions with a few changes. I now basically understand why long descriptions should not make reference to short descriptions, but I also think there are some cases where the short description is so short, basic and easy to understand that the long description can't but help make reference to the short description. I think it is important to remember that we're trying to make the debconf process easy to understand, grammatically correct and to flow naturally. This 'flow naturally' aspect is important, and it's why I thought my original version was O.K. For example, this one (my original proposal) ... _Description: Mantis webmaster e-mail address: This address is displayed at the bottom of all Mantis pages. In this case the short description is so obvious that it really doesn't need a long description. So making reference to it in the long description - in order to let the admin know a little more about the impact of his/her response - doesn't seem inappropriate. Please note that I'm still young in this whole review process, so take my comments above as my way of trying to get a handle on everything. That all said, I thought about it some more and came up with this: _Description: Mantis webmaster e-mail address: - This address is displayed at the bottom of all Mantis pages. + Please enter the webmaster's e-mail address. It will be displayed + at the bottom of all Mantis pages. Hope this, and the other changes, make sense. The attached patch is against the original version in the mantis package. Kevin -- Kevin Coyner GnuPG key: 1024D/8CE11941
Template: mantis/admin
Type: string
Default: mantis@localhost
_Description: Mantis administrator e-mail address:
Please enter the e-mail address of the administrator who will troubleshoot
user reported errors.
Template: mantis/webmaster
Type: string
Default: webmaster@localhost
_Description: Mantis webmaster e-mail address:
Please enter the webmaster's e-mail address. It will be displayed at the
bottom of all Mantis pages.
Template: mantis/from
Type: string
Default: mantis@localhost
_Description: Sender address for bug report e-mails:
Please enter the address used as the origin address for Mantis bug report
e-mails.
Template: mantis/bounce
Type: string
Default: mantis@localhost
_Description: E-mail address for bounce-handling:
Please enter the address where bounced e-mails will be
directed. Typically, this should be set to be the same as the
administrator's e-mail address.
Template: mantis/webserver
Type: multiselect
Choices: apache, apache-ssl, apache-perl, apache2
DefaultChoice: apache2
_Description: Web server to configure:
Apache can be automatically configured to use Mantis by creating links in
/etc/{apache-version}/conf.d/. Select all the versions of Apache you would
like to automatically configure.
Template: mantis/passwordnote
Type: note
_Description: Administrator's password must be changed:
By default the mantis package creates an administrator account.
The password for this account is 'root'.
.
It is highly recommended to change this password immediately after
installation is complete.
--- ../mantis.old/debian/templates 2007-05-28 10:01:17.000000000 -0400
+++ debian/templates 2007-05-31 20:49:53.000000000 -0400
@@ -1,39 +1,47 @@
Template: mantis/admin
Type: string
Default: mantis@localhost
-_Description: Email address of the Mantis Administrator:
- This is mainly prompted to the user in case of errors that might
- require the intervention of the system administrator.
+_Description: Mantis administrator e-mail address:
+ Please enter the e-mail address of the administrator who will troubleshoot
+ user reported errors.
Template: mantis/webmaster
Type: string
Default: webmaster@localhost
-_Description: Email address of the webmaster:
- This address is displayed in the bottom of all Mantis pages.
+_Description: Mantis webmaster e-mail address:
+ Please enter the webmaster's e-mail address. It will be displayed at the
+ bottom of all Mantis pages.
Template: mantis/from
Type: string
Default: mantis@localhost
-_Description: Sender address for bug reports emails:
- This email address will be used in all emails sent by Mantis.
+_Description: Sender address for bug report e-mails:
+ Please enter the address used as the origin address for Mantis bug report
+ e-mails.
Template: mantis/bounce
Type: string
Default: mantis@localhost
-_Description: Email address for bounce-handling:
- Bounced mail is directed to this address. Typically, this is set to
- the administrator's email address.
+_Description: E-mail address for bounce-handling:
+ Please enter the address where bounced e-mails will be
+ directed. Typically, this should be set to be the same as the
+ administrator's e-mail address.
+
Template: mantis/webserver
Type: multiselect
Choices: apache, apache-ssl, apache-perl, apache2
-DefaultChoice: apache2
-_Description: Web server(s) that should be configured automatically:
+DefaultChoice: apache2
+_Description: Web server to configure:
+ Apache can be automatically configured to use Mantis by creating links in
+ /etc/{apache-version}/conf.d/. Select all the versions of Apache you would
+ like to automatically configure.
Template: mantis/passwordnote
Type: note
-_Description: Note on default password
- Per default this package is installed with an Administrator account.
- Password for this account is: root.
+_Description: Administrator's password must be changed:
+ By default the mantis package creates an administrator account.
+ The password for this account is 'root'.
.
- It is highly recommended to change this password after the installation.
+ It is highly recommended to change this password immediately after
+ installation is complete.
--- ../mantis.old/debian/control 2007-05-28 10:01:17.000000000 -0400
+++ debian/control 2007-05-28 15:04:32.000000000 -0400
@@ -10,8 +10,23 @@
Pre-Depends: dbconfig-common
Depends: debconf, apache2 | apache | apache-ssl | apache-perl, libapache2-mod-php5 | libapache2-mod-php4 | libapache2-mod-php4| libapache-mod-php4, php5-mysql | php4-mysql, php5-cli | php4-cli, libphp-adodb, libphp-phpmailer, mysql-client
Description: web-based bug tracking system
- Mantis is a bug tracking system based on PHP / MySQL.
- The software resides on a webserver, while any webbrowser should be able to
- function as a client.
+ Mantis is an issue tracker implemented in PHP. While Mantis features
+ multi-DBMS support, this package automatically installs MySql. It has a
+ significant list of features, including:
+ * Web based access
+ * Simple/advanced issue pages
+ * Multiple projects per instance
+ * Support for projects, sub-projects, and categories
+ * Users can have different access level per project
+ * Changelog support
+ * Roadmap
+ * My View page
+ * Search and filter
+ * Built-in reporting (reports/graphs)
+ * Custom fields
+ * E-mail notifications
+ * Users can monitor specific issues
+ * RSS feeds
+ * and more
.
Homepage: http://www.mantisbugtracker.com
Source: mantis Section: web Priority: optional Maintainer: Patrick Schoenfeld <schoenfeld@in-medias-res.com> Build-Depends: debhelper (>= 5), dpatch, po-debconf Standards-Version: 3.7.2 Package: mantis Architecture: all Pre-Depends: dbconfig-common Depends: debconf, apache2 | apache | apache-ssl | apache-perl, libapache2-mod-php5 | libapache2-mod-php4 | libapache2-mod-php4| libapache-mod-php4, php5-mysql | php4-mysql, php5-cli | php4-cli, libphp-adodb, libphp-phpmailer, mysql-client Description: web-based bug tracking system Mantis is an issue tracker implemented in PHP. While Mantis features multi-DBMS support, this package automatically installs MySql. It has a significant list of features, including: * Web based access * Simple/advanced issue pages * Multiple projects per instance * Support for projects, sub-projects, and categories * Users can have different access level per project * Changelog support * Roadmap * My View page * Search and filter * Built-in reporting (reports/graphs) * Custom fields * E-mail notifications * Users can monitor specific issues * RSS feeds * and more . Homepage: http://www.mantisbugtracker.com
Attachment:
signature.asc
Description: Digital signature