Archive for August, 2008:

XO BookSprint instructions

{ Posted on Aug 25 2008 by annegentle }
1 Comment
Tags : , , , , , , ,
Categories : OLPC
Adam Hyde of FLOSS Manuals wrote up these instructions for how to get involved with the BookSprint going on this week. I'm hoping to write blog entries that describe the planning sessions and surrounding practical advice for this type of ...Read More »

How do people converse about technical topics today?

{ Posted on Aug 22 2008 by annegentle }
1 Comment
Tags : , , ,
Categories : blogging, techpubs, wiki, writing
I have seen the eminent reinvention of technical documentation as we know it, which inspired me to begin chronicling my own observations and shifts in the field of communicating technical topics through conversation. One such revealing moment happened while I was ...Read More »

How can we go towards documentation as conversation?

{ Posted on Aug 20 2008 by annegentle }
5 Comments
Tags : , , ,
Categories : social media, techpubs, tools, work, writing
Tell me… and I will forget. Show me… and I will remember. Involve me… and I will understand. -Confucius Documentation as conversation means getting closer to the users and helping them perform well. Over the years experts such as JoAnn Hackos and ...Read More »

Darwin Information Typing Architecture (DITA) reading list

{ Posted on Aug 15 2008 by annegentle }
3 Comments
Tags : , , , , , , , ,
Categories : DITA, techpubs, work, writing
Here's a reading list for DITA materials when you're just getting started. I've been fielding some questions via email and IM about DITA lately, and pulled this blog post out of my drafts. I hope it's helpful. Learning more about DITA http://justwriteclick.com/2006/05/18/learning-more-about-dita/ Getting ...Read More »

Fun with Wordle

{ Posted on Aug 12 2008 by annegentle }
3 Comments
Categories : blogging, writing
I love this visualization toy, Woordle at http://wordle.net/, and as it turns out, I use the word "love" quite a bit. That and "really." Who knew? :) It's quite fun to make a Wordle because of the animation you see while ...Read More »

A summer experiment with Google AdWords

{ Posted on Aug 11 2008 by annegentle }
1 Comment
Categories : Uncategorized
This summer I had fun writing an article about writing AdWords ads - and seeing if I could use the AdWords network to sell my presentation audio and slide deck, A Technical Writer’s Role in Web 2.0: Wiki-fy Your Doc ...Read More »

Author-it and indexing

{ Posted on Aug 06 2008 by annegentle }
No Comments
Categories : Uncategorized
If you do a search on the Author-it Yahoo Group about indexing, you will find a wide array of knowledge about some of the best ways to set up indexes especially when you have multiple deliverables. If you do a Google ...Read More »

Scriptorium’s Framemaker wiki – knowledge sharing, brain dumping, and learning

{ Posted on Aug 01 2008 by annegentle }
No Comments
Categories : Uncategorized
Honestly, Sarah O'Keefe's blog entry describing the new Scriptorium wiki at wiki.scriptorium.com doesn't do the content justice - there is really, really good stuff on that wiki! I'd love to see this wiki become a hub and community for Framemaker users ...Read More »