Programmers Writing Discussion

Common Language

The programmers might not share a common language with the technical documentation's audience. I don't mean jargon. I mean English to Italian or Mandarin to English. Both cases happened at my former employer.

-- Jay

I think that's probably true. I'm interested in learning how your (former) employer dealt with the issue. It makes some measure of sense to have some technical writers working in the same language as the developers and then other people working on translations.

I've not given a lot of thought to the translation problem, but I do concur that it's an important.

--

Documentation Sucks

My friend Steven, from whom I got the automation page, reminded me of his "Why the Documentation Sucks and What You Can Do About it," talk. It's good. You should take a look.

-- tychoish