# for the control server:
tags 705657 patch
severity 705657 minor
thanks

> Package: chef
> Severity: wishlist
>
> Dear Maintainer,
> please consider to change the 'short description' (aka synopsis)
> of this package so it adhere to the Debian Policy [1]
> (max. 80 characters).

The formatting also happens to be very non-compliant with DevRef
6.2.2, and Policy makes the 80-character limit a "should certainly",
so this must surely count as more than wishlist.

Just trimming it back to "systems integration framework" would do, but
shortening an advert just gives an ineffective advert - instead I
would recommend using something that (a) uses the standard term for
this sort of software but also (b) includes a hint at Chef's special
characteristics:

 Description: recipe-based configuration management system

-- 
JBR     with qualifications in linguistics, experience as a Debian
        sysadmin, and probably no clue about this particular package
diff -ru chef-10.12.0.pristine/debian/control chef-10.12.0/debian/control
--- chef-10.12.0.pristine/debian/control	2013-02-28 12:44:16.000000000 +0000
+++ chef-10.12.0/debian/control	2013-04-18 12:17:26.729102981 +0100
@@ -36,7 +36,7 @@
 Provides: libchef-ruby, libchef-ruby1.8
 Conflicts: libchef-ruby (<< 0.10.10-1~), libchef-ruby1.8 (<< 0.10.10-1~)
 Replaces: libchef-ruby (<< 0.10.10-1~), libchef-ruby1.8 (<< 0.10.10-1~)
-Description: A systems integration framework, built to bring the benefits of configuration management to your entire infrastructure.
+Description: recipe-based configuration management system
  Chef is a systems integration framework and configuration management library
  written in Ruby. Chef provides a Ruby library and API that can be used to
  bring the benefits of configuration management to an entire infrastructure.

Reply via email to