Perl Mailing Lists - Data and Contributing

lists.perl.org
 

Contributing Changes

We know that a lot of the data is out of date, as it has been collected from a variety of sources. Updates are welcome and encouraged.

Please send patches for lists.json (available below) as unified diffs (diff -u) to webmaster at perl.org or via the git repository.

Please use validate.pl to make sure your JSON parses correctly (requires JSON from CPAN). The -d flag dumps out a properly formatted file.

Here's a suggested workflow:

cp lists.json lists.json.old
cp lists.json lists.json.new
edit lists.json.new
validate.pl -d lists.json.new > lists.json
diff -u lists.json.old lists.json

Data

The underlying data for lists.perl.org is available for download in JSON format: lists.json.

Key points:

  • All tags should be sorted. (i.e. $json->canonical(1);)
  • Top level keys should match /^[a-z0-9_.-]+$/
  • archive, nntp, rssfeed may be lists.

TODO List

  • Create a "short description" and "long description" for each list.
  • Mark inactive lists as such.
  • Move categorization into the JSON file (maybe a "tags" element?) instead of hardcoding in the templates
  • Add missing lists. (There are some lists linked on the category pages that aren't in the JSON file, as well as lists we just don't know about.)
  • Write an automated archive-scraper for updating the "last message" timestamp?
  • Do we want to add all public perl monger lists? If so, write a script to sync.