![]() |
|
May 2003 - Issue 49 Technical and Document Writing Know your subject and write! The "Dummies" are out there and growing by leaps and bounds in every category imaginable!
ALSO... Visit EmporiumGazette.com We have our guidelines available for your convenience and have posted our planned monthly themes so you can submit your writing to us. Even our back issues are available. Sign up to receive the Emporium Gazette monthly.
|
|
In this issue: WRITING THE WRITING GRANT PROPOSAL TIPS FOR WRITING TECHNICAL DOCUMENTS FROM ANOTHER ANGLE RHINOism POETRY WORLD I AM, THEREFORE...
|
![]() |
|
|
This is the writing challenge for the month of May. If you decide to accept, only you will be the final judge. Randomly pick an item; any item. Yes, I know you're going to take the proper amount of time to do this, but trust me, just pick an item. Now, examine this item closely and get a clear image in your mind of how this selected piece can be used. In 100-150 words, write a "how-to-use" article that describes the technical aspects necessary for use. An Example: Pencil. Having made sure that the pencil has been properly sharpened (see instructions on page 3 under sharpener) and has a usable eraser on one end (see instructions on page 1), hold the pencil in your correct writing hand (see instructions on page 2). The pencil should rest cradled at the tip of the first two fingers (index finger and IQ designator) of the hand and held in place by the thumb. The pointed end of the pencil, which should have exposed raw wood enclosing the black lead substance, should be down with the eraser leaning back over the hand. Apply point to a piece of paper. With gentle pressure applied, you can now write (see instructions on page 34 for writing instructions).* * * * * If you have a quick or interesting way to break that writer's block and get your creative juices flowing, with it and we'll share it with others as a challenge.
|
|
Haunted Encounters:
Have you ever had a haunting experience? Would you like to see it in
print? Then tell us your story - you can be a part of the upcoming book
HAUNTED ENCOUNTERS: PERSONAL EXPERIENCES WITH THE PARANORMAL!
Personal Experiences with the Paranormal Writers selected for this collection of personal ghost tales will be paid $50.00 upon publication. Your submission should be a 1000-2000 word account of a true, supernatural encounter that you've experienced. No more than 2 photos per story, please. Manuscripts not selected can only be returned to the author if a self-addressed, stamped envelope (SASE) is included with the submission. NO FICTION, PLEASE! Send submissions to:
HAUNTED ENCOUNTERS P.O. Box 600745 Dallas, TX 75360-0745 www.hauntedencounters.com
|
|
Writing a Writing Grant Proposal
At first glance, the title of this article sounds like a tongue-twister, or maybe something akin to expecting you to pilot a Cessna to the airport so you can take flying lessons. If you can write well enough to get a writing grant, you don't need one, right? Not necessarily. This article is one of a series in the Gazette dealing with technical writing. If you're an author in search of a grant to do some writing, there are certain things about crafting such a proposal that will help you get a "yes." This piece will review the major factors that will contribute to your successful grant proposal. Know your audience. Fiction and nonfiction writers alike know the importance of writing for their audiences. The first question to ask when writing a grant proposal for a writing (or any other worthy) project is this: Is the foundation or funding organization you want to approach for a writer's grant offering or willing to make grants to writers for writing projects? Before you begin to craft your proposal, make sure that your target funder will even read what you submit. The Guide to U.S. Foundations is an excellent source for the more than 30,000 American foundations and organizations. A good academic or public library would likely have or have access to the Guide. Another source is an organization called FC Search, which produces a CD-ROM that makes identifying foundations and other granting organizations a matter of a few mouse clicks. Request and then follow the guidelines. Most foundations and grantmakers offer specific guidelines to tell proposal writers what to send. If you've identified a potential funder for a writing project, ask for their written submission guidelines and then follow them. Be brief yet complete. Even as you follow the grantmakers' guidelines, remember that reputable organizations get many more proposals asking for more money than they can possibly satisfy. State your case succinctly and interestingly. Avoid excess verbiage but address all of the matters at hand. Make your proposal's reader want to turn the page all the while being mindful of the fact that there shouldn't be too many pages to turn. Ask for the right amount. If you've done your homework, you'll know the range of grants the foundation or organization has given in the last reporting year. You can be reasonably sure that the higher awards were based on longer-standing relationships between the grantmaker and the recipients. Don't ask for the moon in your first proposal. Better that you get a more modest "yes" than a hefty "no." Grant proposal writing isn't all that different from any other writing. The more compelling it is, the more likely it is to evoke a positive response in the reader. Grant writing requires more precision, but its success or failure in terms of outcome will depend less on nitty-gritty specifics than on your ability to craft persuasive, interesting prose. When you get that acceptance, take special pleasure in writing the thank-you letter, which may well be the precursor to your next grant proposal to that funder. * * * * * timely thriller, Capitol Chill, is available from BuyBooksOnTheWeb.com either on their Web site or by calling toll-free 1-877-BUY-BOOK. His pen name is James Gardiner. He currently has a traditional agent marketing his second work the old-fashioned way. Rogers is at work on the manuscript for his third novel.
|
|
|
|
Tips for Writing Technical Documents
Let's face it. Every writer wants to pen fiction and the Great American Novel. The truth is most don't. Most write technical documents for their day jobs. Boring, you say? Slow, tedious and mind-numbing? It doesn't have to be. Writing technical documents will never be like writing a sci-fi adventure story, but if you wrap your head just right around the challenge, you can produce a non-fiction work of art. So, what is first? Mindset. You have to pump up your
thoughts. Delete that nasty, little voice in your head that insists this kind of writing is 'second-rate' and replace it with a positive attitude. What is the purpose of the paper? What is it supposed to do for the person reading it? Can it be presented as one long, document or do you need to break it into sections? Will it need an index, glossary, table of contents, and an appendix? Is this document intended for the Internet as part of a web site? Or will it be printed, bound and distributed? Once you have determined the purpose of the paper, you can then begin to organize your information. Gather all your sources before you begin to write, and don't just put the info into one big heap. Use a notebook or filing drawer and separate the data into manageable segments. It will make it easier for you to go back and check your facts. The next big thing that you have to concentrate upon is understanding the material yourself. Writing technical documents is not like writing fiction. You must be thoroughly versed in the subject; you cannot draw data from your imagination. Learn the vocabulary and learn the science behind what you are trying to explain. Everything is now organized and at your fingertips. You understand your subject. It is now time for you to decide on the level and type of writing you must produce. Is this technical document for a consumer who may not know all the industry terms? Then, you need to simplify the information so a layman can readily understand what you are saying. Is this paper for insiders who need the nitty-gritty to do their jobs properly? If this is true, then make sure you write toward the expert. Don't write the document to pieces. Less is more, so make sure you include only the information that is necessary for your reader. Also, make sure that you don't try to add your own voice into the document. People who scan technical information are not looking for humorous asides, opinions, or rants. Finally, once the paper is done, have a qualified reader look it over carefully to make sure that you've got the info right. If you follow this basic recipe for writing technical documents, you will always produce on-topic, concise papers that your reader will value and appreciate. * * * * *
is a successful web tutorial writer for the Internet Eye Magazine. She specializes in 2D and 3D graphics production. Visit her website Delphic Moments
|
|
Haunted Encounters:
Have you ever had a haunting experience? Would you like to see it in
print? Then tell us your story - you can be a part of the upcoming book
HAUNTED ENCOUNTERS: PERSONAL EXPERIENCES WITH THE PARANORMAL!
Personal Experiences with the Paranormal Writers selected for this collection of personal ghost tales will be paid $50.00 upon publication. Your submission should be a 1000-2000 word account of a true, supernatural encounter that you've experienced. No more than 2 photos per story, please. Manuscripts not selected can only be returned to the author if a self-addressed, stamped envelope (SASE) is included with the submission. NO FICTION, PLEASE! Send submissions to:
HAUNTED ENCOUNTERS P.O. Box 600745 Dallas, TX 75360-0745 www.hauntedencounters.com
|
|
FROM ANOTHER ANGLE
FOR THE CURIOUS ONLY Let thy speech be short, "Apocrypha" designated religious books that were circulating among the inner circle of a group and kept from the public. Supposedly, these books contained information that was esoteric and only for special ones. The evolved term "apocrypha" evoked the mysterious and clandestine. Apocrypha even appears in the Bible: Mark 4:22 and is commonly translated "secret." As a writer, doesn't it send shivers to think that a word must have peered two thousand or so years into the future to describe hidden aspects in a segment of today's computer language? The following exchange of E-Mails illustrates this phenomenon. "The Diva" refers to the Emporium Gazette's very own Denise Vitola. "What the hootie is an html fragment? Handle it, Jabby, handle it. I want to be webbed, tied, drawn, and quartered with anything the Diva does, just so long as I don't have to figure out what she is talking about. The little green thing is pretty. That's all I know. JPEG is a wooden leg to me. Goldie. Here's the post from Denise that kicked off Goldie's outburst: "Okay, I'm working on it now. It involves sending you guys a small jpg and an html fragment code. Jabs, I'll explain it so it all makes sense as soon as I make sense of it all. "By the way, I've started designing my own seamless background tiles. EC, I came up with the attached tile, thinking about your web pages. Thought I'd send it along in case you find it interesting. It should open with your browser. "Jabs, place the jpg in the same directory as the html page. Code is <BODY BACKGROUND="mintflowers.jpg" TEXT="000000"> It should tile the whole background seamlessly. I think a white or peach-colored text looks good with it. Dark blue, too." I'm with Goldie and probably many of you. The only tiles I know about are in the kitchen and bath. Except for a few English words here and there, Denise's entire E-Mail is apocrypha to me. Being somewhat curious though, I decided probing a bit might give us an inkling of this html stuff. Aha! In a book by Dawn Groves, THE WRITER'S GUIDE TO THE INTERNET, Chapter 7, we can find out "How to Create a Web Page." Already on the first page of the chapter, the hidden language ignorant among us discover that HTML means Hypertext Markup Language. "Web pages (also known as Web documents)," the author says, can be created in any word processor, but many people use specialized HTML editor programs to simplify the task." Looking through the chapter, I see that we seekers could learn a lot, but as for me, at least for the moment, I'll leave it to the experts. I will concede, however, Apocrypha is correct. With HTML under our belt, we could comprehend much in a few short words. * * * * *
Susan Long Turner is co-author with Russ Turner of "Wings Born Out of Dust" which is available now from 23 House Publishing and is also available in trade paperbacks and hardback at other major online bookstores. Visit her Website
|
|
Ten (10) completely original pieces that span and combine the genres of music with interesting twists: Ireland Down Under: Ireland with a
touch of Australia All are available to preview
in either Real Player or Windows Media Player format. It's a free listen
or you may purchase your copy of the audio cd format online!
|