Over the years I've made a number of simple, embarrassing mistakes when putting papers online.
Three of the worst offenders here are that time I
put a paper online with a typo in the title,
published a paper with my own name spelled wrong (pages 1 & 2),
and that other time I
released a paper with a git merge conflict right in the middle of the text (page 24).
Fortunately there's an unreasonably effective method to preventing these mistakes.
Every time I make one (or someone tells me a mistake they made
that I could easily see myself making) I write it down and add it to a checklist.
Each paper I release, I run through the checklist, and as a result will only ever make
the same mistake once.
(This is not my idea.
Checklists are the primary reason airplanes don't fall out of the sky,
and help prevent an uncountable number of deaths in hospitals every day.
They're especially useful in boring situations, where you start to relax
because the hard part is over. Like, for example, when doing the final upload for a
paper after having just spent several months putting it together.)
I recently mentioned that I do this to some people who asked me to share it,
and realized this is something that others might find useful as well.
So here it is.
Incidentally, if you've ever made an easily-preventable mistake,
feel free to let me know and I'll update this list.
Primary checklist for any paper release
This checklist is for any time a paper is being released
Follow it any time you're submitting to a conference,
uploading to arXiv, or submitting a camera ready.
-
Check the paper title is correct.
-
Completely disable any author TODO notes LaTeX macros.
-
Check LaTeX build log and search for "error", "warning", "undefined", "missing".
-
Remove any LaTeX macros from abstract for upload to remote server.
-
Search for doubled words:
r=open("/tmp/paper.tex").read().split();
[a for a,b in zip(r,r[1:]) if a.lower() == b.lower()]
-
Inspect any lines that have a question mark or double periods:
[x for x in open("/tmp/paper.tex") if '..' in x or '?' in x]
-
Make sure the word TODO and FIXME are never present:
[x for x in open("/tmp/paper.tex") if 'TODO' in x or 'FIXME' in x]
-
Verify there are no merge conflicts by looking for '=====', '<<<<', '>>>>'.
-
Visually check that no paragraphs end with a single word on a new line,
and no single lines occur at the top of a new page right below a caption.
Both of these are ugly.
-
Re-read all captions to make sure they are understandable in near-isolation,
and that any final edits didn't break these.
-
Print out PDF from another computer, check fonts still render, and figures are
legible.
Secondary checklist for conference submissions
This checklist is a specific checklist when submitting a paper to a conference. Do the above checklist, and also this one.
-
Check call for papers to ensure rules about blind/non-blind submission.
If blind, search for all author names to ensure they are not present in the document.
-
Follow the CFP rules if pages should be numbered or not numbered.
-
Count pages and verify it's no longer than the page limit.
-
Check for any special rules on the total number of pages
(including the appendix and references) versus content pages.
-
Check bibliography style matches what's expected for this conference.
-
For security papers include something like,
'anonymous submission #xyz' as the author name (with a random formatting, especially when submitting multiple papers to the same conference, to not break anonymity).
Secondary checklist for public releases
This checklist is a specific checklist any time a paper is being released
publicly, e.g., as a camera-ready final paper or an arXiv upload.
Do the primary checklist and this one.
-
All authors are listed on the paper.
-
Author names are spelled correctly, with correct affiliations.
-
Change the template to the “accepted” version of the style, if applicable.
-
Verify including author names doesn't break the flow of text on the page, especially page 1.
-
Check that any copyright block of publication notice is added.
-
Check for the presence of Type 3 fonts, and if they're in the paper, and the conference cares, then I guess just give up and admit you're going to spend the next six hours figuring out how to fix it this time around.
-
Un-comment the acknowledgments section, and any author contribution section.
Secondary checklist for arXiv paper releases
This checklist is a specific checklist any time a paper is being released to arXiv.
You should also follow the public release checklist above.
-
Decide if it's worth running arXiv cleaner to remove comments or if it's okay to others see paper comments.
-
Check that author names on the upload match author names on the submission (except for authors who prefer slight variants on their name for arXiv, e.g., by replacing non-English characters with their English counterpart).
-
Check that any copyright block of publication notice is REMOVED, as appropriate for the venue.
-
Check abstract is formatted correctly without any LaTeX macros present.
-
View rendered PDF and check that formatting is consistent with a local copy.