ERROR: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ' active_time = 1563600939, active_ip = '', acti' at line 2
REPLACE INTO it_active SET active_id = , active_time = 1563600939, active_ip = '', active_user_agent = 'CCBot/2.0 (', active_session = 'j3sqo09vg91n95eandplmemnd7'
ERROR: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ' view_date = NOW(), view_user_ag' at line 3
INSERT INTO en_articleviews SET view_ip = INET_ATON(''), view_user_id = , view_date = NOW(), view_user_agent = 'CCBot/2.0 (', view_referer = '', view_article_id = 11881
ERROR: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ') ORDER BY comment_date ASC' at line 3
SELECT * FROM en_comments, it_users WHERE user_id = comment_author_id AND comment_topic = 11881 AND comment_type = 'articles' AND (comment_state = 1 OR comment_author_id = ) ORDER BY comment_date ASC
You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ') ORDER BY comment_date ASC' at line 3 Technical Writing For Non-Technical Readers Technical Writing For Non-Technical Readers - Article Marketing

Article Marketing

Free Articles, reviews and news releases

Technical Writing For Non-Technical Readers

By: anitrachong | Total views: 121 | Word Count: 966 | Date: Tue, 5 Feb 2013 - 12:55 AM

When you write for your peers, you can use as many technical and esoteric terms as you like. Why? You know they will understand what you're saying; you don't need to explain what, to you, are everyday concepts.
But it's a different story when you need to write for non-technical readers.
Your first task is to really think about your audience, and how you might present your expert knowledge in a way they will understand. Ask yourself:
What are your assumptions about their exposure to your field of expertise, and to the technical terms you use every day?
How many concepts are they likely to understand? How will you explain or illustrate them?
In simple terms, what is your message? What do you want your readers to know or do?
With those answers in mind, you can use these tips to help you achieve clear, engaging and sharp writing. At the heart of your thinking must be:

The more complex your content or the concepts you're writing about, the simpler your writing needs to be.
This is about expressing your thoughts with simplicity, not simplifying your work. Remember your readers: you want to show them the value of your work, not what a good writer you are.
Make sure you've thought about the logical progression of your report. Plan the structure of your document so that you lead your readers to the conclusion you've reached.
The simplicity inherent in the use of plain English (active voice, reasonable sentence length, wise use of specialised terms, no verbosity) will serve you well.
Let's look at some particular areas where this simplicity will help your readers.
Determine the logical structure of your argument. Brainstorming and mind mapping can be valuable tools.
If possible, use headings: they are sign-posts for your readers. Headings give readers an overview and help orientate them, for which your readers will thank you if your content is complex.
Aim for a logical flow in the overall document, within its sections, paragraphs and sentences.
Use familiar words: use instead of utilise, on-going instead of chronic.
Explain unfamiliar concepts. Perhaps footnotes, diagram, glossary or appendix can be helpful - what will be easiest for your readers?
Explain abbreviations, and then use them consistently. You may have to remind readers of their meanings more frequently than you would for your peers.
Watch out for tautologies (new innovations, combine together) and cliches (the bottom line, explore every avenue, moot point).
Keep sentences shorter with a straight-forward, familiar construction.
It's best to address only one concept in each sentence: that can be a main thought with supporting information.
Place your main idea at beginning of sentence: Writing Preventing disruption is our most important issue is preferable to Our bottom line is preventing disruption. The readers' attention is immediately focused on what it is that is so important.
Check that you're not providing unintended humour. A phrase in the wrong place in a sentence can be confusing or laughable.
Yesterday a lively discussion took place about the problem of wild dogs in the council meeting room.
I have discussed the problems of stocking the proposed poultry plant with my colleagues.
Lipolysis can occur in the milk of cows when chilled too quickly.
As with sentences, it's best to have just one main idea (with supporting information) in each paragraph.
That doesn't mean you must confine each concept to just one paragraph. Use as many paragraphs as you need, because a number of shorter paragraphs doesn't intimidate readers as would one long paragraph.
Again, keep the logical progression of your paragraphs within each section.
Bullet point lists can be a useful way to present complex information.
Use a numbered list if order or priority is important.
Maintain structural consistency of points, eg each point as a complete sentence, or each point as a sentence fragment; same part of speech to open each point.
Be consistent in the way you punctuate your lists.
Non-verbal elements:
Illustrations, figures, graphs, charts or other graphics will often be easier for your readers than text.
In the text, make clear cross-references to the graphics, so there can be no question about how the text and the illustration are related.
Be consistent in your use of table and figure captions.
Consider how both text and graphics sit on the pages: paragraph spacing, consistent use of headings, column width and justification, white space balance.
Finally, ask a non-technical 'outsider' to read your work, then tell you what they've understood. That should give you some indication of how well you've done your job.
Before you publish your work, return to those basic questions about your audience and your message. Have you done your best to make it as easy as possible for your readers to understand your work?
Desolie Page is an accredited editor and owner of Perfect Pages.
I give you the confidence that your business and technical writing is clear, engaging and sharp. Together, our aim is to enable your readers to understand your message without struggling with complex language.
As I want you to think of my as your collaborator, I work with you to help you understand your audience, to clearly articulate your message, and to present your writing in a reader-friendly way.
Editing and proofreading are what I most love doing, but I also write copy from supplied information, prepare style guides for organisations with multiple authors, and train writers in the principles of technical writing and in writing strategies.

About the Author

buy term papers online


No comments posted.

Add Comment

You do not have permission to comment. If you log in, you may be able to comment.
Copyright © 2019 - Tutti i diritti riservati - Powered by link UP Europe! P.IVA 09257531005
Associazione Culturale per l'uso didattico ed etico dell'informatica
Sede legale: Via Pietro Rovetti, 190 - 00177 - ROMA