-
Notifications
You must be signed in to change notification settings - Fork 71
Timelines
The deadlines are as follows:
Deadline for article topic selection. This is to ensure that we don't get two people writing about the same module, or someone doesn't accidentally pick a module that we've already covered in the past (both of these are okay, but we'd want to discuss it carefully beforehand)
Check-in point. We'll be in contact with you to check that you're all okay with writing the Advent Calendar entry. This is the point where it's okay to say you can't do this anymore. At this check-in if you can't write the article it's perfectly okay to say at this point that we should find another author for your slot.
First time advent calendar authors probably want to have had a first stab at writing the article at this point.
It's also perfectly okay to say you're having problems with your article and you want help. In the past the doctors have worked with authors to substantially change their articles when the authors themselves were not happy with the way they were turning out.
Deadline for submission of your article (via pull request.)
After your pull request Mark and the other editors will work with you to edit your submission, making tracked changes in git as follows:
- We'll work on fixing up any display issues with the POD -> HTML process
- We'll do some copy editing. This may involve
- Fixing spelling mistakes, typos
- Re-wording sentences to make things clearer
- Fixing bugs in your code examples
- Reformatting your code examples to comply with code style (including changing whitespace, adding more comments, adding use strict and warnings, etc)
- Adding sections to cover missed aspects of the topic you're working on
- Adding extra graphics (for example, in the past we've graphed data, or even done our own benchmarks when an author has said something was faster and graphed that)
- Adding additional story, peril, or other fluff to match the advent calendar style.
It's more important to get something in on November 1st than it is to get something perfect. Perfect is great, but done is better.
The article will be scheduled by this point. You'll get an email letting you know when your article will be going live.
At this point the Advent Calendar editors will make no "substantive change" to the article (I..e will limit changes to correcting typos, spelling errors, rending mistakes and adding missing links to the SEE ALSO section.)
The author will be sent an email reminding her that this deadline has happened, and giving her a chance to point out if the editor has done something dumb.