Paper writing features

A list of cool “features” or writing techniques that I’ve seen in papers; in the text itself, the citations, figures, etc.

Direct PDF linking. The DOI isn’t there, which isn’t great though (link could break?)

Looks like this:
Screenshot from 2021-06-10 23-56-28

From the HamPath user guide:

In legal documents, footcites containing quotes from the work cited

Screenshot from 2021-06-11 17-16-20

Acknowledgements on first page, funding on last

Screenshot from 2021-06-13 16-50-06

Lin RR, Assistant R, Kascak AF, Professor A, Alexander RM. Active Control of Transient Rotordynamic Vibration of Optimal Control Methods,". 1988.

Detailed and exhaustive nomenclature. Might be improved by adding a definition for each part.

“They’re communicating to the public” sgu 832 title

Determination of bang-bang controls for large nonlinear systems, David Donald Niemann

Has an entire chapter devoted to “conclusions and recommendations”, which also includes key drawbacks. I like this layout.

Screenshot from 2021-06-20 00-33-34

Google scholar only indexes papers (outside accepted) with explicit bibliography sections. This rules out some ‘alternative’ (bottom of page) bib styles.

What a pleasant chart theme.
Screenshot from 2021-07-02 13-48-50

Technical abstract / plain language summary


Screenshot from 2021-07-12 13-14-19

In fact, could the summary be written by other people - the reviewers, say?

One thing to keep in mind is when scanning in old documents to institutional repositories, the OCR of some scanners can completely mangle math
Screenshot from 2021-08-02 16-38-04

Darwin usually speaks in the first person plural when analyzing empirical evidence he has collected and only uses the first person singular when he is specifically speaking about his own actions, such as, “…many special facts which I have collected,” or when he is speaking about his own qualms, such as “I am well aware that there are on, on this view, many cases of difficulty, some of which I am trying to investigate.” However, when analyzing his evidence, he always uses “we”, such as “we notice”, or “we understand”(2). Darwin’s change in footing when he is explaining his theory places himself and the reader on the same level and makes him a more “humble” presenter, allowing us to suspend disbelief for at least the time being and trust him.

Add with instructions on how to repeat, guidelines on validation requirements, things to watch out for, etc

add automated unit test with virtualenv to check that installation process goes without a hitch - check python version

Adding line numbers to preprints makes text difficult to select and copy. The same is true of two-panel layouts, which usually copy improperly.

Screenshot from 2021-11-05 11-15-20

Nomenclature with units

Screenshot from 2021-11-22 14-07-40

An abstract with background/objective/methods/conclusion - neat!

Another neat abstract formalization

I’ve noticed a defect in how I write in a logbook.

Need to maintain a precise control over the nouns and verbs. It’s easy to write sentences in an ambiguous way that can’t be easily understood later. For instance:

The machine had been removed from the rack. The wire on the machine was removed. I then re-inserted it.

Which it does re-inserted refer to? This is a clunky example, but a more general problem


Machine #32, acme pulse shaper model 3352, had been removed from rack 3 and was laying on the ground. Wire 7 on the machine was not connected. D.C. then re-inserted wire 7 into socket 3.