Dienstag, März 25, 2014

10 Things Tech Writers Want Developers to Know

Dr. Dobbs: 10 Things Tech Writers Want Developers to Know

  • Crisp, Clear, Concise Communication
  • Precise Instructions
  • Avoid OON (Overheating the Optic Nerve)
  • Purge Needless Politeness
  • Accurate, Thorough, Timely Reviews
  • Reasonable Edits
  • Revere Visuals
  • Spell Out Acronyms
  • Be Monolingual
  • Expect Translation
  • Use the same term or expression for the same concept.
  • Avoid expressions that are culture specific.
  • Use plain words.
  • Use vertical lists.
  • Use active voice wherever possible.

Das sind doch mehr als 10? Naja.

Spruch des Tages

A person who won't read
has no advantage over one
who can't read.

Mark Twain

Donnerstag, Januar 23, 2014

Montag, Januar 13, 2014

Tools für Programmhilfe & technische Dokumentation

Dr. Explain (240€)

Help and Manual (480€)

Madcap Flare (999$)

Adobe Robohelp (1400€)

Noch ein paar

Donnerstag, November 21, 2013

Schach-WM 2013 Videokommentare

Von Daniel King gibt es auf Spiegel Online Videokommentare zu den Spielen auf Deutsch. Sehr schön! Aber leider hakt es immer wieder beim Abspielen und Vorspulen.

Wunderbar: auf Youtube gibt es die gleichen Kommentare von Daniel King auf Englisch.

Mittwoch, Oktober 02, 2013

Spruch des Tages

There is no such thing as public opinion. There is only published opinion.

- Winston Churchill

Montag, September 30, 2013

Zote des Tages

Die Aktion ist sowas von durchsichtig,
das geht nicht einmal mehr als Negligé durch.

Donnerstag, September 26, 2013

Feinstaub bei Benzinmotoren

http://www.heise.de/tp/artikel/35/35548/1.html

Benzinmotoren mit Direkteinspritzung können Dieselmotoren beim Ausstoß von Partikeln problemlos in den Schatten stellen

Dienstag, September 10, 2013

Host JavaScript in .NET: ClearScript

http://clearscript.codeplex.com/

(via)

NYT: How Laura Poitras Helped Snowden Spill His Secrets

http://www.nytimes.com/2013/08/18/magazine/laura-poitras-snowden.html

Poitras endured the airport searches for years with little public complaint, lest her protests generate more suspicion and hostility from the government, but last year she reached a breaking point. While being interrogated at Newark after a flight from Britain, she was told she could not take notes. On the advice of lawyers, Poitras always recorded the names of border agents and the questions they asked and the material they copied or seized. But at Newark, an agent threatened to handcuff her if she continued writing. She was told that she was being barred from writing anything down because she might use her pen as a weapon.

“Then I asked for crayons,” Poitras recalled, “and he said no to crayons.”

She was taken into another room and interrogated by three agents — one was behind her, another asked the questions, the third was a supervisor. “It went on for maybe an hour and a half,” she said. “I was taking notes of their questions, or trying to, and they yelled at me. I said, ‘Show me the law where it says I can’t take notes.’ We were in a sense debating what they were trying to forbid me from doing. They said, ‘We are the ones asking the questions.’ It was a pretty aggressive, antagonistic encounter.”