Re: [RFR] Description for package openacs

[Ben Finney <ben+debian@benfinney.id.au>]

Hector Romojaro <hromojaro@dia.uned.es> writes:

> I'd like to ask for review of the openacs package description:
>
> Description: Open Architecture Community System

The synopsis should, IMO, be descriptive rather than an expansion of an
initialism. Just as the package name is most often used in isolation
from any description, the package name plus synopsis is most often used
in isolation from the full description. So that pairing (package name
plus synopsis) should be as informative as feasible.

My suggestion:

    toolkit for building community-oriented web applications

The expansion of the initialism and the technologies involved are, to my
mind, of secondary importance, below describing the purpose of the
package, when visually scanning a list of package names plus synopses.

>  OpenACS (Open Architecture Community System) is a toolkit for building
>  scalable, community-oriented web applications which are based on
>  AOLServer web server and the Tcl language.

This could usefully be split into two sentences:

    OpenACS (Open Architecture Community System) is a toolkit for building
    scalable, community-oriented web applications. It is based on the
    Tcl language and the AOLServer web server.

-- 
 \      “By instructing students how to learn, unlearn, and relearn, a |
  `\         powerful new dimension can be added to education.” —Alvin |
_o__)                                    Toffler, _Future Shock_, 1970 |
Ben Finney