There’s a moment that everyone who presents or speaks in public fears. And I entered that moment during a presentation last week.
I went blank.
Stage fright. Freezing up. A very pregnant pause. None of those terms really sum up what happened to me during that talk. I went all tabula. As in rasa. It wasn’t pleasant, for me or for my audience.
Here’s a look at what happened, and what I learned from the experience.
If you’re not familiar with a book sprint, read this for details.
This book sprint came about because:
- For the last two years, I’ve been promising Adam Hyde (head honcho of the FLOSS Manuals project) that I’d take a more active part in a book sprint
- I thought that this would be an interesting event to hold at Toronto Open Source Week
This time around, the goal was to complete a manual for the Mozilla Thunderbird email client. I hosted the book sprint in Toronto, and Adam Hyde took overall control from Berlin (where he lives).
It was an interesting two days, to say the least. Here’s a summary of what went down.
Below are the slides and notes for the presentation on FLOSS Manuals that Scott gave at FSOSS 2010. You can also find them on our page at Slideshare.
- Anne Gentle looks at Web analytics for documentation sites
- Some good examples of bad technical writing
- Tom Johnson ponders why tech comm is the career path of last resort for students
- Some usability advice for those times you’re working with a Web-based CMS
- Yes, we really need to speak the customer’s language
Jargon. Acronyms. They’re everywhere. Yes, even in technical communication.
Jargon and acronyms have helped bloat the English language and contributed to a level of obfuscation and confusion that’s deeper than an unknown foreign language. In fact, people who overuse jargon and acronyms often sound like they’re speaking a foreign tongue. Or just speaking in tongues …
As technical writers, we regularly run into this. I sure do. Worse, we can’t seem to escape jargon or acronyms.
But that doesn’t mean we have to put up with either. We can do a lot to minimize the amount of jargon and the number of acronyms in what we write. By doing so, we can make what they’re trying to convey clearer for any reader.