Checklist of common JMLR formatting errors
General
-
Make sure your abstract reads well. It will be used to advertise your paper.
- We recommend you use small caps for system names.
-
Order of paper: At the end of your paper, the order of sections should be:
Acknowledgments, Appendices, then References.
-
Acknowledgments should be a unnumbered section. You can use the \acks{}
command for this.
-
Appendix section number should be a letter (Should look like Appendix A.
Title). You can use \appendix followed by regular \section command to format
appendices
Title Area
-
Capitalization of paper title: In the title area, the paper title should be
in title case. (First letter of each word capitalized except for little
words like "and" and "or".)
-
Author contact addresses: These should be complete enough that mail sent to
that address will reach them
-
Editor listed: Please include the name of the Action Editor who handled your
submission in the \editor{} tag
-
Keyword: Please add keywords to your article using \begin{keywords} ...
\end{keywords} after your abstract. They should not be capitalised, they
should be separated by commas, and they should not have a period at the end.
-
Abstract: Do not delete the % at the end of \begin{abstract}% as it
introduces an extra indent
-
Title should be split across two lines, only when it is too long for one
line.
Headers and Footers
-
Front page header: Use the \jmlrheading command to get a correct header and
footer on the title page
-
Copyright notice, bottom of front page uses authors full names: In the
\jmlrheading command, please use the full names of all authors
-
Running headers: Add running headers to your paper using the \ShortHeadings
command. Please see the example paper on the web site for how to do this.
-
Running headers: In the \ShortHeadings command, please capitalise the words
in your paper title.
-
Running headers: In the author list in the \ShortHeadings command, please
use "and" before the last author
-
Running headers: The ShortHeadings author list should have last names only,
and should list all authors if possible. If you have many authors, "et al."
is acceptable.
Section Headers
-
No unnumbered sections: We do not use \paragraph or \section*. We do not
allow bold, unindented text to begin a paragraph that could be mistaken for
a section header. If it looks like a section header it needs to be numbered
like a section header, otherwise it needs to be formatted in some other way
(e.g., by indentation, or by using italics instead of boldface).
-
Section numbering: All sections, subsections, subsubsubsections must be
numbered. Please use \subsubsection instead of \subsubsection*, etc
-
Capitalization of Section headings: All section headings should be title
case. (First letter of each word capitalized except for little words like
"and" and "or".) This includes subsections, sub subsections, etc.
-
Section headers: There must be some text separating all section headers
Tables and Figures
-
Float placement: In general, floats should be at the top or bottom of the
page (avoid using [h] option to \begin{figure}). Check for pages that
contain several floats and only 2-3 lines of text. These will be confusing
for a reader, who is likely to miss the text. When this happens, please put
the floats on a floats page ([p] specifier) instead.
-
Floats should also be placed as close as possible to the page at which they
are first referenced. You should not, e.g., place all of the figures at the
end of the paper.
- Figures, tables should be centered
- Captions should be underneath figures and tables
- Captions NOT in italics, bold
- Tables and figures should not overfill margins
-
Multiline captions should have a hanging indent, that is, subsequent lines
of the caption should be indented, aligning with the first word of the
caption rather than the word "Figure". Usually this problem is caused by one
of the other packages that you have included. Sometimes changing the order
of includes will fix this (try moving the jmlr2e include farther down).
Footnotes
- Footnote markers should follow punctuation
- Footnotes should be complete sentences
Misc
-
Dashes: When using dashes in text, please use --- instead of --, with no
space before or after---like this.
- Data set: We use "data set" rather than "dataset".
Citations
-
Carefully read the section on citations in
Instructions for Formatting JMLR Articles. A quick guideline is that the paper should still
read correctly if all parenthesized text were omitted. Here are examples of
BAD citations:
- "See (Ginsberg, 1994) for an analysis..." [Uses citation as a noun]
-
"Drummond (Drummond, 1994) showed that..." [Should be "Drummond (1994)"]
-
"...the best method (see the ERT test (Davis, 1995))..." [double parens,
should be "...best method (see the ERT test, Davis, 1995)..."]
-
Citations not nested in parenthesis. Parentheses should not occur within
parentheses, even for citations. Within parentheses use \citealt or \citealp
instead. Or you can use \citep[e.g.,][]{smith00}.
Object References
-
Use \url commands to reference urls in papers. This causes hyperref to make
the hyperlinks work nicely
-
Parenthesis: \eqref can sometimes result in parentheses within parentheses.
When referencing an equation within a parenthetical statement, use Equation
1 rather than (1) or Equation (1).
-
When referencing figures, sections, etc. ("Figure 1", "Section 2.1"), please
make sure the words "Figure", "Section", etc., are uppercase
Math
-
Punctuation: Math in formal writing should be punctuated as if the extra
space is not there, for example, displayed equations should usually be
followed by a comma or a period, depending on the surrounding text.
-
Punctuation: Before displayed equations, punctuation (e.g., ":") is not
necessary unless you would use the same punctuation if the equation were not
there.
-
In general, only equations that are referenced should be numbered. We are
willing to relax this for equations that are particularly important, as
others may wish to discuss these in later correspondence.
- Proofs should end with a filled box.
-
Equations should not run over the right hand margin. Appendices are
especially prone to this.
-
Theorems, Lemmas, etc., should be labeled like Theorem 1, Theorem 2, Theorem
3, not as Theorem 2.1, Theorem 2.2, Theorem 2.3
References
- It is preferable to cite published papers, rather than tech reports.
-
Author names: Make citations consistent. Either give the full first name of
all cited authors, or give the first initials only for all cited authors.
-
Capitalization in paper titles: Titles of conference papers should have the
first word only titles. However, watch out for words like Bayes and Markov.
These should still be capitalized, but BibTeX often leaves uncapitalised
incorrectly.
-
Capitalization of book titles, etc: The parts in italics (book names,
journal names, conf names) should be title case. (First letter of each word
capitalized except for little words like "and" and "or".)
-
Please cite conference titles consistently. We do not have a enforced style
for conference names, but whichever style you choose, be consistent. Don't
refer to the same conference as "AAAI 2004" in one reference and the "The
Nineteenth National Conference on Artificial Intelligence" in another one.
Personally, I prefer the style "International Conference on Machine Learning
(ICML)", leaving off the "Proceedings of the Twentieth..."
Mastodon