Skip to content

Latest commit

 

History

History
107 lines (53 loc) · 4.14 KB

paper-writing.md

File metadata and controls

107 lines (53 loc) · 4.14 KB

Tips on paper writing

[Link to the original tweet]

Sharing one idea I found useful for paper writing:

Do NOT ask people to solve correspondence problems.

Some Dos and Don'ts examples below:

Figures

Don't ask people to match (a), (b), (c) ... with the descriptions in the figure caption.

Figures

Figure caption

Use "self-contained" caption. It's annoying to dig into the texts and match them to the figures. Ain't nobody got time for that! ⌚️

Also, add a figure "caption title" (in bold fonts). It allows readers to navigate through figures quickly.

Figures

Notations

Give specific, meaningful names to your math notations. For example, the readers won't need to go back and forth to figure what each term means.

Figures

Which

I found that many of my students love to use "which" in their sentences. I hate it ... because I often cannot figure out what exactly "which" refers to. Break it down into simple sentences and spell out what that subject of the sentence is.

Figures

Respectively

It's hard to parse which corresponds to which in the sentence that ends with "respectively" (have to solve a long-range correspondence problem). Break them them so that one sentence talks about one thing.

Figures

Citations

People like to use many acronyms for their methods. It may be hard for readers to memorize/match which method/dataset/metric you are referring to. Adding citations is an easy way to fix this.

Figures

Names for notations

When using notations in the sentences, mention their "names" as well. The readers won't need to flip through your papers to look up what these notations mean.

Figures

Connect figures with equations, notations, and sections

I view the overview figure in a paper a centralized hub that connects all the important equations, notations, and sections in one place. This makes it easy for people to understand how everything fits together.

Figures

Tables

Factorize the variants/attributes of different methods so that it becomes clear to compare one with another.

Figures

One table, one message

Decompose your big table so that each table conveys exactly one thing. This avoids people from having to compare results from distant rows. Having multiple smaller tables gets the point across easier. (Don't worry about the redundancy.)

Figures

Group subfigures

Don't ask readers to figure out the grouping (b-c) and (d-e) in the caption when you explicitly group them.

How to create underbracket? Ex:

$\underbracket[1pt][2.0mm]{\hspace{\FIGWIDTH}}_%
{\substack{\vspace{-2.0mm}\ \colorbox{white}{(a) Input}}}$

Figures

Parallelism

When applicable, use repetitive grammatical elements in your sentence. It helps the readers to easily parse the parallel concepts you want to convey.

Figures

Table organization

Merge tables sharing the same structure. Label the metric (the larger/smaller the better) with up-arrow and down-arrow so that your readers don't need to look them up.

Figures

Shape attributes

Leverage the shape attributes (color, thickness) to encode the message.

Also, use a deemphasized image in the background to avoid mental matching.

Figures