# 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.