TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:how to get APIs into your portfolio? From:Jonnie Pekelny <jonniep -at- peoplepc -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Sun, 27 Oct 2002 04:39:58 -0800
Hello, all. I'm delurking on this list, for a question that may prove
quite important to my career. I've been a tech. writer for over ten
years, but have recently been unemployed. In my background I've written
all kinds of docs, including APIs, but, in the gay 90s, I never thought
to keep APIs for my portfolio. Reasons? APIs are usually big bulky and
boring books, written for very specialized audiences, difficult to
display in small fragments and not necessarily the best medium for
showing off a person's writing skills to a lay person -- IMO. So, I
never bothered keeping them for my samples. Big mistake.
It's now become apparent to me that I need to get at least one API
sample into my portfolio, since it's become increasingly difficult to
find jobs without "proving" that I can write APIs. (The big secret is
that APIs are actually some of the easiest books to write, since so many
of them are basically reference volumes).
In the past, all the items in my portfolio have come from documentation
I have written on the job, particularly the more technical samples.
That's not an option right now. And I can't volunteer to take six months
to write a programmer's guide from scratch for no pay. My question to
you all is, do you have any strategies or suggestions for how to go
about creating an API-type writing sample that shows that I can do that
type of writing? I welcome all opinions!
Thanks.
Jonnie Pekelny
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Buy ComponentOne Doc-To-Help 6.0, the most powerful SINGLE SOURCE HELP
AUTHORING TOOL for MS Word. SAVE $100 on the full version and $50 on the
upgrade. Offer ends 10/31/2002 (code: DTH102250). http://www.componentone.com/d2hlist1002
All-new RoboHelp X3 is now shipping! Get single sourcing, print-quality
documentation, conditional text and much more, in the most monumental
release ever. Save $100! Order online at http://www.ehelp.com/techwr-l
---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.