Re: Writing samples and portfolios

Subject: Re: Writing samples and portfolios
From: voxwoman <voxwoman -at- gmail -dot- com>
To: "Janet Swisher" <jmswisher -at- gmail -dot- com>
Date: Mon, 1 Dec 2008 20:08:09 -0500

On Mon, Dec 1, 2008 at 6:32 PM, Janet Swisher <jmswisher -at- gmail -dot- com> wrote:

> On Mon, Dec 1, 2008 at 9:30 AM, T S <tens00 -at- gmail -dot- com> wrote:
> >>
> >> Is this what everyone does, write for open source software?
>
> Heh. As far as I can tell, the idea of working on open source projects
> is only beginning to get traction in the techcomm world. I know of
> only a handful of tech writers who are actually doing it (see
> http://www.janetswisher.com/?itemid=152).
>
> I was pleased to see it come up as the first couple of suggestions on
> this thread. In the past, more common advice would have been to "make
> something up" for a product you're familiar with. *If* you're going to
> go to the trouble to create something from scratch, then doing it for
> an open source project makes a lot more sense to me than
> re-documenting another company's product, or an imaginary one. It's a
> "real" software product with actual users, who can benefit from your
> efforts. You have to plan your efforts and interact with developers to
> get information. That is more impressive to me than writing a doc for
> something where you either already know the technical details, or just
> make them up.
>
> >> Is there
> >> anything else you do with your existing information? I would love to
> >> leverage what I have
>
> Gene's suggestion for presenting redacted documents is one way to go
> about it. Another is to post what you can as-is, and put a note on
> your website that "Additional writing samples are available, but may
> only be viewed during an in-person interview, due to their proprietary
> content." That lets prospective employers know that you *have* done
> more than what's on your website.
>
> >> as (and I'm hesitant to say this) my life is already
> >> extremely busy with work and family and I just do not see being able to
> >> commit to a project outside of my existing job.
>
> No need to feel guilty for having a life :-) It seems that
> programmers who want to program in their spare time work on open
> source, and tech writers who want to write in their spare time write
> fiction :-)


I wish more tech writers would document open source software, because the
documentation that is there reads like it was written by developers. Do you
have experience with the open source community - are the developers willing
to spend time explaining things to the writers so the writer can write about
it?

-Wendy

>
>
>
>
> --
> Visit my blog at: http://www.janetswisher.com
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
> solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
> HTML and publish to the Web, Help systems or printed manuals.
> http://www.doctohelp.com
>
> Help & Manual 5: The complete help authoring tool for individual
> authors and teams. Professional power, intuitive interface. Write
> once, publish to 8 formats. Multi-user authoring and version control!
> http://www.helpandmanual.com/
>
> ---
> You are currently subscribed to TECHWR-L as voxwoman -at- gmail -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/voxwoman%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.
http://www.doctohelp.com

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


Follow-Ups:

References:
Re: Writing samples and portfolios: From: T S
Re: Writing samples and portfolios: From: Janet Swisher

Previous by Author: Re: FW: the old insure ensure assure
Next by Author: Re: Your opinion about help authoring tools
Previous by Thread: Re: Writing samples and portfolios
Next by Thread: Re: Writing samples and portfolios


What this post helpful? Share it with friends and colleagues:


Sponsored Ads