How to write a technical report

There are many good sources on the basics of writing a technical report, see 1, 2 (pdf), 3 (pdf). What I want to emphasize in this blog post is the actual writing process.

I found that it is difficult to write a report after you have done the technical work, feel exhausted, and want to move on to greener pastures (i.e. new technical challenges). The most productive approach is to begin writing before you have started any analysis, i.e. when you don't have a clue what you're going to do. I start by taking notes on the blank report about why I am undertaking this effort, what mathematical tools I might need to develop, what scenarios I might try. Thereby, I make up my mind on how I will approach the problem. That allows me to get over one of the main procrastination reasons, namely not knowing where to start. This makes the report an integral part of the overall picture. The rest is following/updating your outline and filling the blanks (and sometimes realizing you are at a dead end and giving up).

Your report and analysis will be finished at the same time and both of them will be much better than if you had done them separately.

Update 31.10.2012: See In Defense of the Scientific Paper for similar ideas.

p.s. Having more than one computer monitor where you will use one for the report and one for the calculations, is a big productivity boost.

p.p.s For basic English writing rules, see The Elements of Style

music:
* Akrep Nalan - Sarhoş
* Adele - Set Fire to the Rain
* Placebo - Every You, Every Me (covered by Basement Alchemy)

Film: Changeling

Changeling filmi 1928'de yaşanan bir olaya dayanıyor. Küçük oğlu kaybolan annenin oğlunu bulma mücadelesini ve bu sırada polisin kendisine kötü muamelesini anlatıyor. Beni etkileyen kısmı kadının otorite/güç karşısındaki çaresizliği ve direnişi idi. Nedense aklıma ruhsat maceramız ve İzmir'de polislerce dövülen kadın geldi... Nedense... Sözlerimizi filmden bir alıntı ile bitirelim:

Fuck you and the horse you rode in on!

Wired

Thanks to Umut, I read the September and November issued of Wired magazine. I found it entertaining (no surprise there considering my character). For example, check out Self-Help for Nerds:

Ladies will be sexually aroused to know that I was the Memphis City Junior High Chess Champion of 1983.

Nerds get caught up in minutiae, because there is a tremendous and fulfilling sense of control in understanding every single detail of a thing more than any other living creature.

We are hyper-self-aware. We have difficulty “chilling out.”

It’s the nerd’s greatest weakness that is the nerdist’s greatest strength: a laserlike ability to focus on something. Nerdist = obsession + direction.

Nerds tend to spend a lot of time in the past and future, but to achieve happiness you have to cultivate the skill of living in the present.

Another interesting read was The Wired Atlas of the Human Ecosystem.
In short, if you are a nerd and have some time left from other serious things (like optimizing your Civilization IV strategies), go read Wired.

music:
* Morcheeba - Otherwise
* Finley Quaye - Dice