Skip to content

Advent Calendar planning

Boyd Duffee edited this page Dec 12, 2024 · 1 revision

Here are notes and suggestions from running the PDL Advent Calendar in 2024.

Authors

Starting in September, email potential authors on the pdl-general and pdl-devel maillists and post a Call for Articles on the #pdl channel in IRC. Because no one answers a general call (almost no one ever does), follow up a week later with individual emails, perhaps suggesting topics based on your knowledge of what they're working on or where their interests lie.

Involved authors can check out the look of their post using a local copy of Statocles

Authors will need:

  • create statocles-site/ ... 12/09/slug/ directory
  • article called index.markdown (use 4 space indents for code blocks)
  • banner image
  • article metadata in yaml at top of article
  • author bio in site.yml

TODO find the rest of mohawk's notes for authors and add them here

Installing and using Statocles

TODO add in git commands to keep auto-generated files from turning up in git status

Organizing

  • create a Project to handle the organization
  • create articles as Issues with Dec 9 - Title name to hold the discussion on the article. Use the green Advent Calendar label.
  • when making a Pull Request, put Fixed #Issue in the title or the first line of the PR to link it to the Issue
  • Let Ed generate the website content or put that into a devops-y Github Action
  • Putting up a week at a time lets people binge and redditors can post into the future
  • Get as much written in advance as possible

Promotion

  • email Gabor and Mohammad at Perl Weekly
  • email Len Jaffe at Advent Planet
  • post on PerlMonks
  • post on Hacker News; try not adding text. Let the first curious person write their comment rather than give people a tl;dr they can ignore
  • brian d foy has posted the entries on reddit at r/perl

Article Ideas

A lot of the demos have already been turned into articles, but the Introduction and Bad Values could be used verbatim next time.

Check out the 2024 Issue tracker for lots more ideas, but check which ones have been used already.

Clone this wiki locally