[Pkg-cacti-maint] Bug#653897: [RFR] templates://cacti/{cacti.templates}

[Justin B Rye]

Christian PERRIER wrote:
> +_Description: Web server:
> + Please select the web server for which Cacti should be automatically
>   configured.
>   .
> + Select "None" if you would like to configure the web server manually.

Looking good.
 
Then in the control file:
>  Package: cacti
>  Architecture: all
>  Depends: apache2 | apache | apache-ssl | apache-perl | httpd, [...]
                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
(Apache-what?)

> -Description: Frontend to rrdtool for monitoring systems and services
> +Description: web frontend for graphing systems and services monitoring data

That doesn't quite work - is it a frontend for graphingsystems and for
services which are monitoring data, or a frontend for
graphing-systems-and-services (which also monitors data), or what?
The original was already a bit ambiguous - does it mean that it's a
 * "front-end for monitoring-systems and monitoring-services"?
 * "front-end for monitoring-systems and for services"?
 * "front-end for doing some monitoring of systems and services"?
 * "front-end for services and for doing some monitoring of systems"?
I'm going to try suggesting:

   Description: web interface for graphing of monitoring systems

> + Cacti is a complete frontend to rrdtool. It stores all of the necessary
>   information to create graphs and populates them with data in a MySQL
> + database. It only uses PHP. Along with being able
>   to maintain Graphs, Data Sources, and Round Robin Archives in a
> + database, Cacti also handles data gathering. It also includes SNMP
>   support for those used to creating traffic graphs with MRTG.

Dictionaries prefer the two-word spelling "front end" whereas
developers tend to prefer "frontend"; since this isn't in section
devel I'll use my normal compromise of "front-end".

"It only uses PHP" isn't really accurate - it also uses RRDTool,
MySQL, and so on.  It seems to me this fact would fit in neatly as the
expression "PHP-driven" in the first sentence (a phrase I have no
objection to - I prefer it to "PHP-based" for a start).

The way it talks about creating and populating graphs and then
maintaining data sources and then data gathering also seems easy to
compress.

Why the capitalisation of Graphs, Data Sources, etc (and not rrdtool)?

Avoid "also" twice on one line.

I'd suggest:

    Cacti is a complete PHP-driven front-end for RRDTool. It stores all of
    the necessary data source information to create graphs, handles the data
    gathering, and populates the MySQL database with round-robin archives.
    It also includes SNMP support for those used to creating traffic graphs
    with MRTG.

>   .
>   This package requires a functional MySQL database server on either the
> + installation host or a remotely accessible system.

That looks fine.  

(ObWhyTheName: some sort of reference to the way its graphs are
covered in spikes?)
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
-------------- next part --------------
diff -ru cacti.old/cacti.templates cacti/cacti.templates
--- cacti.old/cacti.templates	2012-01-06 01:16:15.571695523 +0000
+++ cacti/cacti.templates	2012-01-06 01:19:41.311362179 +0000
@@ -2,8 +2,8 @@
 Type: select
 __Choices: Apache2, None
 Default: Apache2
-_Description: Webserver type
- Please select the webserver type for which cacti should be automatically
+_Description: Web server:
+ Please select the web server for which Cacti should be automatically
  configured.
  .
- Select "None" if you would like to configure your webserver by hand.
+ Select "None" if you would like to configure the web server manually.
diff -ru cacti.old/control cacti/control
--- cacti.old/control	2012-01-06 01:16:18.171695475 +0000
+++ cacti/control	2012-01-06 01:19:25.279362216 +0000
@@ -13,15 +13,12 @@
 Depends: apache2 | apache | apache-ssl | apache-perl | httpd, libapache2-mod-php5 | php5, php5-mysql, php5-cli, php5-snmp, virtual-mysql-client, rrdtool, snmp, libphp-adodb (>= 4.50-1), ucf, dbconfig-common (>= 1.8.8), ${misc:Depends}
 Recommends: mysql-server, iputils-ping, logrotate
 Suggests: php5-ldap
-Description: Frontend to rrdtool for monitoring systems and services
- Cacti is a complete frontend to rrdtool, it stores all of the necessary
- information to create graphs and populates them with data in a MySQL
- database.  The frontend is completely PHP driven.  Along with being able
- to maintain Graphs, Data Sources, and Round Robin Archives in a
- database, cacti handles the data gathering also.  There is also SNMP
- support for those used to creating traffic graphs with MRTG.
+Description: web interface for graphing of monitoring systems
+ Cacti is a complete PHP-driven front-end for RRDTool. It stores all of
+ the necessary data source information to create graphs, handles the data
+ gathering, and populates the MySQL database with round-robin archives.
+ It also includes SNMP support for those used to creating traffic graphs
+ with MRTG.
  .
  This package requires a functional MySQL database server on either the
- installation host or remotely accessible system.  If you do not already
- have a database server available, you should also install mysql-server.
- 
+ installation host or a remotely accessible system.
-------------- next part --------------
Template: cacti/webserver
Type: select
__Choices: Apache2, None
Default: Apache2
_Description: Web server:
 Please select the web server for which Cacti should be automatically
 configured.
 .
 Select "None" if you would like to configure the web server manually.
-------------- next part --------------
Source: cacti
Section: web
Priority: extra
Maintainer: Sean Finney <seanius at debian.org>
Build-Depends: debhelper (>= 5), po-debconf, quilt
Homepage: http://www.cacti.net/
Vcs-Browser: http://git.debian.org/?p=users/seanius/cacti.git
Vcs-Git: git://git.debian.org/git/users/seanius/cacti.git
Standards-Version: 3.9.1

Package: cacti
Architecture: all
Depends: apache2 | apache | apache-ssl | apache-perl | httpd, libapache2-mod-php5 | php5, php5-mysql, php5-cli, php5-snmp, virtual-mysql-client, rrdtool, snmp, libphp-adodb (>= 4.50-1), ucf, dbconfig-common (>= 1.8.8), ${misc:Depends}
Recommends: mysql-server, iputils-ping, logrotate
Suggests: php5-ldap
Description: web interface for graphing of monitoring systems
 Cacti is a complete PHP-driven front-end for RRDTool. It stores all of
 the necessary data source information to create graphs, handles the data
 gathering, and populates the MySQL database with round-robin archives.
 It also includes SNMP support for those used to creating traffic graphs
 with MRTG.
 .
 This package requires a functional MySQL database server on either the
 installation host or a remotely accessible system.