Latex Style

Check this out if you use LaTeX. A lot of insightful tips.

If you have problems with Illustrator and PSfrag, that’s probably because you can’t have psfrag replace tags with more than one character, once you saved the EPS with Illustrator. I think I found the solution, at least using CS5, and if the file is not too complicated. When saving the EPS, choose for Version the Illustrator 3 EPS. In this way you’ll be able to replace tags with more than one character.

Art is a generous action—it’s when a human connects to another human and makes a change.

Seth Godin

Well, why would I wanto to do that? Because in general djvu’s take up less space. Anyway, if you have a Mac with macports, issue from the terminal

    sudo port install pdf2djvu

and then use it with

    pdf2djvu -o name_of_the_file.djvu  --monochrome name_of_the_file.pdf 

where I used

    --monochrome

because I just had a black and white pdf. For more options,

    man pdf2djvu

Presentation zen

Nice article by Garry Reynolds on presentation openings. Must read if you care about your audience.

Shawn Blanc on writing

Very nice article by Shawn. Take home message: re-writing, re-editing. And repeat. Repeat. Repeat. With respect to this, very similar to Gruber’s view on how Apple Rolls.

Presentation zen

Just as the meaning of Japanese cuisine goes far beyond sustenance, the significance of the bath goes far beyond merely washing.

Presentation zen

Great article from Garr about the lessons we can learn from bamboo. Be sure to check out it’s blog for a lot of other great articles

As written previously, here’s the second post about writing scientific articles. So the objective is to have people read, remember and cite our work. What makes an article a good articles?

Good title

When scrolling through the new articles of the day, or through the results of a search engine, we see only the titles of the papers. If the title is boring, unattractive, or if it doesn’t explain what you have accomplished, we will have a hard time clicking on it. The title has to lure the readers inside the paper, the same way carnivorous plants lure insects in their traps. Once inside, as opposite to plants traps, the readers are still free to go, so we need to write it right to keep them inside. But they have to get in, so spend some time on the title, brainstorm with your colleagues, take a walk, a ride, whatever: find a good title!

First and last sentence

The first and last sentence of the article are the most important. The first says in which area the article is and connects it to our everyday life. The last says what you have accomplished and state which implications your work will have for science and for the rest of the world. Writing them right is extremely important. It just so happen that one of the teacher found my first sentence beautiful (I’m not picking this adjective up, that’s what he wrote), so here you go

Every cell in our body, whose typical size is 10 micron, contains DNA which, if stretched, would be approximately two meters long.

The sentence is very simple, short, yet states the problem very clearly: the DNA cannot fit in our cells if not compacted in some way. Body, cells, length, they are all things people understand, or feel connected to.

If after these two sentences the reader is still there, then probably the abstract is the next chewed thing.

Good abstract

The abstract has to contain your whole article in short. State the problem, why do we care about it, how you solved the problem or a part of it, the consequences for the world and future works. It is kind of shrank, but that’s how people want it. If the results are clearly stated, then they may cite you without even reading the rest of the paper (this is not a good practice but, alas, so it happens). So in general you may write the abstract for people who only read it, skipping all the rest (except first and last sentence). So don’t refer to figures or equation: the abstract should be self-contained.

All the rest

After the first sentence, make things more and more specific, but let all the technicalities outside the introduction. Explain here the 3 letters acronyms you will use later, except if sure everyone knows them (for example DNA or, maybe, LHC).

You can use a friendly style when writing, but do NOT write a diary, like: the first day we found this and that, and that he came along saying this, so we changed the method, etc. No one care about it. If you want to write a diary, use MacJournal or OrgMode or whatever suits you. Do not waste journal space.

How to structure the article

How much introduction (I), how much calculations and results (R), how much discussion (D)? Well, something like in the picture below. And what about the methods and the algorithms we are so proud of? They may just go in the Appendix, or, if space is an issue, a complementary materials pdf. If someone is really interested about your work, they will look it up, don’t worry.

All the article should follow the basic principles of storytelling, which is create a tension inside the reader so that he want to finish the article, is curious about the end. Every writer, from Andersen to Bulgakov, knows that. You tell something to the reader, but not all, you make him curious, let him experience some tension, and, at the end, but only at the end, you give him what he wants. That’s a long story made short, because story telling needs years to be mastered and books to be learned. If you want to know more about it, you can begin here: writing a good story is very similar to writing a good article or delivering a great presentation, because inside every scientist there once was a kid who once heard Snow-white, Hansel and Gretel, etc. (I’m not kidding!).

Keywords

Spend some time on keywords, because this is how your article is going to pop-up when searching for its contents. Keywords are word which are relevant to the paper and are not in the title (they are already indexed, so don’t repeat yourself). Try to think what would you search if you wanted to find your article. Monitor the article in your field to see what the others used as keywords. And use this neat trick if there is a paper very similar to yours, already published and very good: if you think those who read that paper should also read yours, copy some keywords of that paper: when searching for them, both will pop up; and if you listened to what I said and therefore have a title sexy enough, people will read your paper too!

That’s it

Well, this was basically what I learned from the course. If it happens that you will have the opportunity to follow it, just do it! The webpages of the write it right course is at, rare enough, http://write-it-right.org/.

As a PhD student for FOM I’m offered to follow some soft-skill courses during my career. These included the ‘Art of Presenting Science’ and ‘Write it right’. The latter ended Friday, 16 of April, and it was a two days course teaching how to write better papers. But why should we write it right? There are several reasons. But probably we care just about one. Publishing! If we want to make a living out of our scientific career we have to publish as much as possible. This means to convince one editor and two referees that our work is worth! But how? First we have to lure them into our articles. Then the articles have to be enough sexy to keep them reading, understanding and agreeing.

This is not only true for the referees: you also want the other readers to keep reading, to understand and to agree. Only in this way they will cite your papers, they will make you famous and eventually they will offer you a job.

Well, let me tell you, it surely seems like a hell of a job. But reading on will help you getting things done.

Keep it simple

Although good in English, we are not native speakers. The simpler we keep it, the less mistakes. Furthermore, most of the readers have an english level lower than ours: so KEEP IT SIMPLE! Use the Gunning fog index if unsure about a passage. This index is designed to keep your sentences short and without complicated words. You do not have to show off your English: you will impress your referees with your results, so keep the English simple and out of the way.

There is another reason to keep a sentence short: our attention-per-sentence vanishes after 30 words. Then try to avoid anything longer than 15: in this way you will not only keep your audience, but they will also feel smart: they’re understanding this difficult bosonic nuclear reacting stuff paper with little effort! And if the introduction in the article is well written, they will cite your clear and easy (yet complete!) paper when writing their own. Another free lunch that comes if you stay away from long sentences, is that they are more difficult to keep coherent and to construct.

Speaking of construct, avoid all unnecessary constructions! Don’t use It could be noted that: just replace it with Note. The same holds for In order to: a to will make the same job, for less typing. If is possible to shorten a sentence while preserving the sense, then go for it! The two examples above are, well, just examples, there are many more cases where this applies.

Example

It is the scope of this paper to determine which..

becomes

Here we determine which..

This was a personal mistake I did in my exercise (before taking the course), and the correct form looks 1000 times nicer than the original.

Another advice is to use the active form instead of the passive one. The passive one seems more formal, more objective, but keeps the reader away from the subject and it is longer reading and using it. It is archaic in the blog and twitter era. If everywhere around passive is less and less used, reading a paper all written in passive form feels weird. Do we want our readers to feel weird? No we want them feeling comfortable with us, we want them citing us! But this is not the only reason: writing passive sentences without mistakes is more difficult, so keep them active!

There are however cases where you need the passive form: use it, but not too much (they advised us to write the article 2/3 in the active form, and 1/3 in the passive one, so keep these proportions in mind).

All the above should contribute to a shorter paper, which is good for three reason

• journals have a limited amount of pages per year, therefore editors like short articles;

• referees do not care about journals space limit; they care however for their time limit: the shorter an article, the more time they have for their things

• if a reader can learn about your results in 4 pages, he will not be happy when reading about them in 10!

Better technical English

Journals do not publish articles poorly written. The first thing a referee has to say is whether the article is clear and written in correct English. So in addition to what said above

• avoid the to + verb form: it is better the verb + ing, because often the infinite is wrongly used.

• the pompous it, or pit: when you find a it in your paper, ask yourself “To what does it refer?”. If you can answer the question, keep it, otherwise “off with his head”.

Example

In order to access information it is necessary…

becomes

To access information is necessary…

Not only the it is gone, but also In order to is replaced by to. Without changing the sense of the sentence.

• use inverted commas around a word only when is used in a novel way or uncommon context

• avoid repetition we said that we would like to see whether we are able to convince you that we…

• do not use abbreviations like don’t or he’s: they are a bit slangy and they may be ambiguous: does he’s mean he has or he is?

• Avoid double negation to say a positive thing.

Example

Do not make it longer than..

becomes

Make it shorter than..