[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFR] templates://no-ip/{templates}



(this is the second review for this package's templates after some new
templates were added)

Please find, for review, the debconf templates and packages descriptions for the no-ip source package.

This review will last from Tuesday, November 06, 2007 to Friday, November 16, 2007.

Please send reviews as unified diffs (diff -u) against the original
files. Comments about your proposed changes will be appreciated.

Your review should be sent as an answer to this mail.

When appropriate, I will send intermediate requests for review, with
"[RFRn]" (n>=2) as a subject tag.

When we will reach a consensus, I send a "Last Chance For
Comments" mail with "[LCFC]" as a subject tag.

Finally, the reviewed templates will be sent to the package maintainer
as a bug report, and a mail will be sent to this list with "[BTS]" as
a subject tag.

Rationale:
--- ../no-ip.old/debian/templates	2007-11-02 08:25:15.638518492 +0100
+++ debian/templates	2007-11-06 10:17:46.055324892 +0100
@@ -26,12 +26,11 @@
 
 Template: noip2/matchlist
 Type: string
-_Description: List of Hosts/Groups:
- Please specify a list of hosts or groups to be updated (separated by
- spaces and/or commas). 
+_Description: List of hosts or groups:

Uncapitalize

+ Please specify a comma- or space-separated list of hosts or groups to update.

More common wording. Avoid passive voice.

  .
- Leave blank to force update of all hosts/groups in your No-IP.com
- account.  
+ If you leave this field empty, all hosts and groups listed in your No-IP.com
+ account will be updated.

Common wording to explain what happens if the setting is not set

 
 Template: noip2/netdevice
 Type: string
@@ -39,14 +38,13 @@
  Please specify the name of the network device connected to the
  Internet (typically ethX or pppX, where X is a number).
  .
- Leave blank if you have only one network device.
+ This field may be left empty if this host has a single network interface.

Unpersonnalize. Not possible to say "If you leave this field empty" in
that case.

 
 Template: noip2/forcenatoff
 Type: boolean
 Default: false
-_Description: Force NAT off
- Please specify whether noip2 should NOT attempt to detect the
+_Description: Disable Network Address Translation (NAT)?
+ Please specify whether noip2 should not attempt to detect the
  external IP address of this computer.
  .
- You probably don't need to modify this.
- 
+ If in doubt, you should leave the default choice.

I strongly suggest to *revert* that choice. Here you're asking the
user to decide whether she should NOT enable an option. That's double
negation and most users will just be confused.

Why not just ask "Enable NAT"?" with a default to "true"?

Otherwise, explain what NAT is (unjargonize).

Reword the "just don't change the setting, dude" sentence.

-- 


# These templates have been reviewed by the debian-l10n-english
# team
#
# If modifications/additions/rewording are needed, please ask
# debian-l10n-english@lists.debian.org for advice.
#
# Even minor modifications require translation updates and such
# changes should be coordinated with translators and reviewers.

Template: noip2/username
Type: string
_Description: No-IP.com user name:
 Please enter your No-IP.com account user name (usually your email address).

Template: noip2/password
Type: password
_Description: No-IP.com password:
 Please enter your No-IP.com account password.

Template: noip2/updating
Type: string
Default: 30
_Description: Update interval (in minutes):
 Please enter the updating frequency (in minutes) the noip2 client
 should use to refresh the record of your IP address.

Template: noip2/matchlist
Type: string
_Description: List of hosts or groups:
 Please specify a comma- or space-separated list of hosts or groups to update.
 .
 If you leave this field empty, all hosts and groups listed in your No-IP.com
 account will be updated.

Template: noip2/netdevice
Type: string
_Description: Network device name:
 Please specify the name of the network device connected to the
 Internet (typically ethX or pppX, where X is a number).
 .
 This field may be left empty if this host has a single network interface.

Template: noip2/forcenatoff
Type: boolean
Default: false
_Description: Disable Network Address Translation (NAT)?
 Please specify whether noip2 should not attempt to detect the
 external IP address of this computer.
 .
 If in doubt, you should leave the default choice.
--- ../no-ip.old/debian/templates	2007-11-02 08:25:15.638518492 +0100
+++ debian/templates	2007-11-06 10:17:46.055324892 +0100
@@ -26,12 +26,11 @@
 
 Template: noip2/matchlist
 Type: string
-_Description: List of Hosts/Groups:
- Please specify a list of hosts or groups to be updated (separated by
- spaces and/or commas). 
+_Description: List of hosts or groups:
+ Please specify a comma- or space-separated list of hosts or groups to update.
  .
- Leave blank to force update of all hosts/groups in your No-IP.com
- account.  
+ If you leave this field empty, all hosts and groups listed in your No-IP.com
+ account will be updated.
 
 Template: noip2/netdevice
 Type: string
@@ -39,14 +38,13 @@
  Please specify the name of the network device connected to the
  Internet (typically ethX or pppX, where X is a number).
  .
- Leave blank if you have only one network device.
+ This field may be left empty if this host has a single network interface.
 
 Template: noip2/forcenatoff
 Type: boolean
 Default: false
-_Description: Force NAT off
- Please specify whether noip2 should NOT attempt to detect the
+_Description: Disable Network Address Translation (NAT)?
+ Please specify whether noip2 should not attempt to detect the
  external IP address of this computer.
  .
- You probably don't need to modify this.
- 
+ If in doubt, you should leave the default choice.
Source: no-ip
Section: net
Priority: optional
Maintainer: Otavio Salvador <otavio@debian.org>
Uploaders: Andres Mejia <mcitadel@gmail.com>
Build-Depends: debhelper (>= 5), po-debconf, quilt
Standards-Version: 3.7.2
XS-Vcs-Git: git://git.debian.org/git/collab-maint/no-ip.git
XS-Vcs-Browser: http://git.debian.org/?p=collab-maint/no-ip.git

Package: noip2
Replaces: no-ip
Provides: no-ip
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: client for dynamic DNS service
 This package provides the No-IP.com Dynamic DNS update client.
 .
 When configured correctly, the client will check the local IP address at a
 given time interval. If it
 has changed, the client will notify NO-IP.com DNS servers and update the
 IP address for your No-IP/No-IP+ host name.
 .
 Home Page: http://www.no-ip.com
  Homepage: http://www.no-ip.com

Attachment: signature.asc
Description: Digital signature


Reply to: