10 questions for a profession

11/11/2006; 2:30 PM

I'm starting a new game. This may be a bit more intellectually demanding than the boyfriend or the 'where I'm from' games, but hopefully more rewarding. Actually I might start a new section in the blog called silly games.

The game is this: Ask 10 questions regarding any profession. The questions must be directly related to the profession not generic questions.

My first set of questions is for an unconventional job in the software industry. The documentation writer.

  1. What type of documentation do you usually write (user manuals, API documentation, or other documentation)?
  2. With the event of the web many programs are publishing their documentation on the web. What medium do you prefer for publishing documentation, web or HTML, PDF files or printed documentation?
  3. With whom do you interact most in the development team to write the documentation?
  4. What part of the documentation do you prefer writing?
  5. Have you got any tricks of the trade of making your documentation more accessible to be understood by the non-technical person?
  6. What do you think about the quality software documentation in general?
  7. Do you feel that your role in the production of software is appreciated enough?
  8. Would you write documentation for an open source project?
  9. Did you ever contribute to improve the usability of a product while you were documenting it?
  10. What do you think is the major shortcoming software developers have when they write the documentation themselves?

If you're a documentation writer and would like to reply, please feel free to comment.

You're also free to play along and write your own 10 questions to a profession of your choice. What I might try to do is find some people with blogs in the mentioned profession and ask them to answer the questions.

621. Seth Dillingham on 11/14/2006

Ooh, sounds like a great party game.

;-)