<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>On Writing a Book &#187; SmartDraw</title>
	<atom:link href="http://www.on-writing-a-book.com/tag/smartdraw/feed" rel="self" type="application/rss+xml" />
	<link>http://www.on-writing-a-book.com</link>
	<description>Tips, tools, and techniques on writing technical books...</description>
	<lastBuildDate>Sun, 16 Oct 2011 06:29:33 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.3.1</generator>
		<item>
		<title>On Writing an Article&#8230;</title>
		<link>http://www.on-writing-a-book.com/2008/02/10/on-writing-an-article.html</link>
		<comments>http://www.on-writing-a-book.com/2008/02/10/on-writing-an-article.html#comments</comments>
		<pubDate>Sun, 10 Feb 2008 06:44:07 +0000</pubDate>
		<dc:creator>Alexis Leon</dc:creator>
				<category><![CDATA[Articles]]></category>
		<category><![CDATA[Article Writing]]></category>
		<category><![CDATA[BenefIT Magazine]]></category>
		<category><![CDATA[MindManager]]></category>
		<category><![CDATA[OneNote]]></category>
		<category><![CDATA[SmartDraw]]></category>
		<category><![CDATA[Word]]></category>

		<guid isPermaLink="false">http://www.on-writing-a-book.com/2008/02/10/on-writing-an-article.html</guid>
		<description><![CDATA[Many people have asked me how I write the technical articles for magazines and blogs, book and product reviews, and the non-technical ones for my personal blog. In this article, I will try to explain my writing process. I usually write the posts for my personal blog straight from the heart, the only thing that [...]]]></description>
			<content:encoded><![CDATA[<p>Many people have asked me how I write the technical articles for magazines and blogs, book and product reviews, and the non-technical ones for my personal blog. In this article, I will try to explain my writing process.</p>
<p>I usually write the <strong>posts</strong> for my <a href="http://www.alexisleon.com/ros/">personal blog</a> straight from the heart, the only thing that I do is check for grammatical, style and usage errors. I usually keep it for one day and then read it once again and if I am satisfied, I post it.</p>
<p>The <strong>book reviews</strong>, I write, after reading the book a few times. I note down the interesting ideas and thoughts, the good aspects, the areas where the author could have improved, and so on. The next thing I do is to give a &#8216;one-to-two&#8217; sentence description of each chapter or section depending on the nature of the book. Finally, I conclude the review with my recommendation—for whom the book will be useful and how useful it will be. Usually I also comment on the readability, the layout, the binding, how the book could have been improved, etc.</p>
<p><span id="more-24"></span></p>
<p>For writing <strong>product reviews</strong>, I use the product for at least a few weeks, sometimes more.  I usually don’t read the Reviewer’s Guide given by the product vendors as I prefer to form my own opinions and reach my own conclusions. When I review a product (software or hardware) some of the questions that I seek answers are: who will benefit from the product, who are the potential users, how the product will improve the productivity, how the product could be improved, how it compares with the competing products, and so on. Once I post the review, I usually send a mail to the vendor giving him a more technical review about the additional features that could improve the value to the users, the bugs that I have found while testing, better marketing strategies like a market segment that could use the product but not addressed by the vendor and so on. This has helped me in making many friends around the world.</p>
<p>Writing <strong>technical articles for my web sites</strong> follow the same process as writing for magazines but does not involve the processes like editorial review, incorporation of review comments, and so on. As soon as I finish the article (of course after editing, rewriting, proofing, and so on),  I upload it to the web site.</p>
<p>Writing <strong>technical article for magazines</strong> is the longest process as it involves many people—sponsoring editor, review panel, writer, copyeditor, layout designers, and so on. Also there are editorial guidelines, which are unique for each magazine. They also vary in detail from a single sentence (the article should not be more than 3500 words) to very comprehensive guidelines as to how it should be structured, what is allowed and what is not, and so on.</p>
<p>All articles begin as an idea—sometimes I get an idea and I will ask the sponsoring editor whether she is interested in that idea; sometimes I give a list of 7–8 ideas and ask her to choose what she likes. The query sent to the editor will contain the title of the article with a one-paragraph synopsis. Two examples are given below:</p>
<blockquote><p><strong>ERP Alone is not Enough…</strong><br />
ERP packages have certain limitations. These limitations will prevent the organization will reap the full benefits of implementing the ERP systems. ERP systems streamline and automate only one segment of the supply chain; for the rest of the segments, the ERP system should be integrated with various technologies. This article discusses those technologies and explains how to integrate those technologies to the ERP system.</p></blockquote>
<blockquote><p><strong>Surviving and Staying Ahead…</strong><br />
How to survive and stay ahead of competition in today’s highly competitive world. The article will cover topics like how to use technology effectively, how to continuously learn (learning organization), continuously improve (Kaizen), how to be agile and more responsive, how to streamline and automate business process and functions, how to use information as a competitive weapon and so on.</p></blockquote>
<p>Sometimes I am asked to write about a particular topic. In such cases, the editorial board will give a one-paragraph synopsis of what they want. Thus the origin of the idea can come from various sources. Once the idea is approved, the writing process starts. I will describe my writing process with the example of an article that I have written for the <a href="http://www.benefitmag.com/"><strong>BenefIT Magazine</strong></a> — <strong>ERP Alone is not Enough…</strong></p>
<p>Once I decide to write the article, I pull up my old notebooks to see if there are any resources that I could use—it could be a book, a quote, an example, or a case study. When I read a book, magazine or journal, I write down the ideas, thoughts, references, and sentences that I like in my <a href="http://www.moleskineasia.com/"><strong>Moleskine</strong></a> notebook. So my notebooks are the first source that I check. If there is something useful, then I will look up those resources and make notes—elaborate notes. Here the idea is to gather as much information as possible so that I will have enough material once I start writing.</p>
<p>The next step is searching the Internet for relevant information. My primary search tool is <a href="http://www.google.com/">Google</a>, but I also use <a href="http://www.clusty.com/">Clusty</a>, <a href="http://www.a9.com/">Amazon’s A9</a>, <a href="http://www.ask.com/">Ask</a>, <a href="http://www.alexa.com/">Alexa</a>, <a href="http://www.live.com/">Live Search</a>, and so on. I also search the digital libraries like <a href="http://portal.acm.org/dl.cfm">ACM Digital Library </a>, <a href="http://www.computer.org/portal/site/csdl/">IEEE Computer Society Digital Library</a>, Web sites of magazines like <a href="http://harvardbusinessonline.hbsp.harvard.edu/hbsp/index.jsp">Harvard Business Review</a>, <a href="http://www.sciamdigital.com/">Scientific American Digital</a>, <a href="http://www.nature.com/">Nature</a>, etc. While searching these on-line resources, I will take notes—again elaborate ones as before. The only difference is that here I will be copying and pasting the information I want to <a href="http://office.microsoft.com/en-us/onenote/default.aspx">OneNote</a>.</p>
<p>Once I think I have enough material, I will go through them a few times. Then I will write the first outline of the article, the first and second level headings on a paper. Once I think I have a reasonably solid outline, I transfer the outline to my Moleskine. If it is an article of about 3000–3500 words, I only need to fill one page of the notebook. If the outline goes to a second page, it means the article will be longer. So I try to fit everything into one page. The outline that I created for the article “ERP Alone is not Enough…” is shown below:</p>
<p align="center"><a href="http://www.on-writing-a-book.com/figs/erpnotes.jpg" target="_blank"><img src="http://www.on-writing-a-book.com/figs/erpnotess.jpg" alt="" /></a><br />
<strong>Article Outline in my Moleskine</strong> (Click on the image to enlarge)</p>
<p>I use a lot of symbols, colors, and images while making the notes. It makes the process more interesting and outcome more satisfactory. Armed with the article outline, I open my mind mapping software—<a href="http://www.mindjet.com/us/products/mindmanager_pro7/">MindManager </a> and create a mind map.</p>
<p align="center"><a href="http://www.on-writing-a-book.com/figs/ERPl.png" target="_blank"><img src="http://www.on-writing-a-book.com/figs/ERPs.png" alt="" /></a><br />
<strong> Article Outline in MindManager</strong> (Click on the image to enlarge)</p>
<p>MindManager is the leading mind mapping software and my favorite. The advantage of using a mind mapping is the ease of organization and reorganization. I just have to simply drag and drop the topic or subtopic from one branch to the other to reorganize it. Also, mind mapping helps in generating more ideas than a linear note taking or brain storming session. Once the mind map is completed, I export the outline to <a href="http://office.microsoft.com/en-us/word/">MS-Word</a>. The exported outline <a href="http://www.on-writing-a-book.com/download/erp_outline.pdf" target="_blank"> (erp_outline.pdf)</a> forms the basis of the article.</p>
<p>Now you must be wondering whether I am out of mind to do this kind of iterative process. But believe me; with each iteration, the article becoming clearer, more organized and better.</p>
<p>The actual writing takes a few hours. Here all the research and homework I have done helps in completing the article very quickly. When I am writing the first draft, I write from the heart without thinking about grammar, style, organization—write without interrupting the flow.  Actually that is a tip that I got from two masters—<a href="http://www.on-writing-a-book.com/2007/09/08/on-writing-well.html" target="_blank">William Zinsser</a> and <a href="http://www.on-writing-a-book.com/2007/10/10/on-writing.html" target="_blank">Stephen King</a>.</p>
<p>Once the first draft is complete, I go through it a few times with a critical mind. Here the main objective is to find grammatical and usage errors, logical errors, and organize the sentences and paragraphs better. While I am revising the article, I usually get new ideas—a better example, a more meaningful case study, a more precise and concise explanation, etc. I will incorporate those into the article—sometimes replacing the existing ones with the new ones and sometimes adding the new things to the document.</p>
<p>Once the article is complete, I edit it to remove the flab and make it concise. Another reason for editing is to bring the word count to the specified number. After completing the article, I usually leave it alone for a day and then start editing it once again. I find it much easier and more efficient as I can edit with a fresh mind. I am able to edit it better and in most cases improve the quality also. Once the editing is done I use two tools—<strong>StyleWriter</strong> and <strong>Readability Studio</strong>.</p>
<p><a href="http://www.stylewriter-usa.com/">StyleWriter </a> searches the document for writing faults, including complex words, jargon and abstract words, wordy phrases, hidden verbs, passive verbs, clichés and long sentences. It is an excellent tool in finding the mistakes that escaped the editing and rewriting processes. It also offers suggestions that will improve the readability, make the sentences crispier and clearer.</p>
<p><a href="http://www.oleandersolutions.com/readabilitystudio.html">Readability Studio</a> analyzes the document and calculates the popular readability scores. Some of the scores calculated are New Dale-Chall, Spache, Laesbarhedsindex (LIX), Rate Index (RIX), SMOG, Flesch Reading Ease, Flesch-Kincaid, Gunning Fog, etc. It also generates the reports of difficult words used in the document, words that are repeated many times, and a host of other results that will help in improving the document and making it more suitable for the intended audience.</p>
<p>You can increase the impact of an article with an apt quotation and improve the readability with a suitable illustration. Quotations can be obtained by searching the Internet or from a quotation library. Quotations are ideal for stressing a point with the help of someone else. As Woodrow Wilson, the 28th U.S. President, said, &#8220;I not only use all the brains I have, but all that I can borrow.&#8221; The quotation library I use is the <a href="http://cybernation.com/qlibrary/">Ultimate Success Quotation Library</a>. This is a fully searchable library—you can search on subject, author, key words, and so on. You can also add your favorite quotations to the database. For creating illustrations, I use <a href="http://www.on-writing-a-book.com/2008/02/08/smartdraw.html">SmartDraw</a>. It is one of the leading graphics packages and is easy to learn and use. You can create professional quality images using it. The image I created for the article is given below:</p>
<p align="center"><a href="http://www.on-writing-a-book.com/figs/erpsd.png" target="_blank"><img src="http://www.on-writing-a-book.com/figs/erpsds.png" alt="" /></a><br />
<strong>Image created using SmartDraw</strong> (Click on the image to enlarge)</p>
<p>Once the images are incorporated, the final document is ready and I send it <a href="http://www.on-writing-a-book.com/download/ERP_BenefIT.pdf" target="_blank"> (ERP_BenefIT.pdf)</a> to the editor.</p>
<p>The review panel will go through the article and see if it confirms to the magazines standards and editorial guidelines. Once approved, the article is given to the copyeditor. A good copyeditor is every author’s best friend. According to Stephen King, “<em>The editor is always right. To write is human, to edit is divine.</em>” The copyeditor goes through the document and makes it more readable, appealing and interesting. Once the copyediting is completed the edited version is sent back to me for my approval and for checking whether there are any technical errors. Sometimes the copyeditor will mark some queries, ask to rewrite a sentence or paragraph for better readability.</p>
<p>Once I incorporate the changes suggested by the copyeditor and approve the copyeditor’s changes, the article is given to the layout designer who will insert the graphic elements, artwork, and blurbs and produce the final output that will appear in print. Given below is the article as it appeared in the January 2008 issue of <a href="http://www.benefitmag.com/previousissue.asp?month=January&amp;year=2008&amp;tot=1&amp;id=19" target="_blank">BenefIT magazine</a>. It is titled <strong>ERP Works Wonders With Multi-Application Support</strong>. Compare it with the document that I sent <a href="http://www.on-writing-a-book.com/download/ERP_BenefIT.pdf" target="_blank"> (ERP-BenefIT.pdf)</a> and you will understand the value addition done during the copyediting, layout design and final production stages.</p>
<p align="center"><a href="http://www.on-writing-a-book.com/download/ERP_Jan_2008.pdf" target="_blank"><img src="http://www.on-writing-a-book.com/figs/erp.png" alt="" /></a><br />
<strong>BenefIT Magazine, January 2008</strong><br />
(Click on the image to open the document)</p>
]]></content:encoded>
			<wfw:commentRss>http://www.on-writing-a-book.com/2008/02/10/on-writing-an-article.html/feed</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
		<item>
		<title>SmartDraw</title>
		<link>http://www.on-writing-a-book.com/2008/02/08/smartdraw.html</link>
		<comments>http://www.on-writing-a-book.com/2008/02/08/smartdraw.html#comments</comments>
		<pubDate>Fri, 08 Feb 2008 07:04:50 +0000</pubDate>
		<dc:creator>Alexis Leon</dc:creator>
				<category><![CDATA[Tool Reviews]]></category>
		<category><![CDATA[Drawing]]></category>
		<category><![CDATA[Graphics]]></category>
		<category><![CDATA[Illustration]]></category>
		<category><![CDATA[SmartDraw]]></category>

		<guid isPermaLink="false">http://www.on-writing-a-book.com/2008/02/08/smartdraw.html</guid>
		<description><![CDATA[SmartDraw is one of the most popular graphics software. It can be used for many purposes from creating flowcharts, high quality illustrations and diagrams, project management chart, floor plans, landscapes and so on. One can use the excellent templates available to jump start the process or start from scratch depending on the level of comfort [...]]]></description>
			<content:encoded><![CDATA[<p><img src="http://www.on-writing-a-book.com/figs/stars-5-0.gif" alt="" /></p>
<p align="center"><img src="http://www.on-writing-a-book.com/figs/sdbox.jpg" alt="" /></p>
<p>SmartDraw is one of the most popular graphics software. It can be used for many purposes from creating flowcharts, high quality illustrations and diagrams, project management chart, floor plans, landscapes and so on.</p>
<p>One can use the excellent templates available to jump start the process or start from scratch depending on the level of comfort and the nature of the drawing. One advantage of SmartDraw is its short learning curve and one can create professional quality illustration, diagrams and charts in a matter of minutes. While a creative and expert artist can make the drawings and illustrations come alive, an average user can also create high quality charts and figures. The short learning curve and ease-of-use are two factors that make this exemplary product more popular and usable.</p>
<p><span id="more-23"></span></p>
<p>The people at <a href="http://www.smartdraw.com/"><strong>SmartDraw</strong></a> have created detailed videos, whitepapers, sample diagrams and charts, and a host of other materials that will help the user in becoming proficient in using SmartDraw very quickly.</p>
<p>There are many other uses for SmartDraw like presentations, business process diagrams, flow charts, project management charts, landscapes, floor plans, organizational charts, mind maps, etc. In this review, I will concentrate on how SmartDraw will help you in creating the drawings and illustrations for the book or article that you are writing.<br />
SmartDraw can help you in two ways. First, when you want to convey an idea of a diagram to your graphic designer, instead of a hand drawn figure, you can create it in a matter of minutes using SmartDraw and save it in any of the popular graphic file formats.</p>
<p>The second and more important use is that you can create your own drawings and illustrations without the help of a professional graphic artist. SmartDraw templates and an excellent searchable image library help you in creating high quality images that will add the extra value to your book or article. The features like aligning, grouping, rotating, ordering, making all objects of equal size, and so on makes your tasks easier and quality of the images better. For example, given below are some of the images created using SmartDraw.</p>
<p><a href="http://www.on-writing-a-book.com/figs/sd01.png" target="_blank"><img src="http://www.on-writing-a-book.com/figs/sd01s.png" alt="" /></a><a href="http://www.on-writing-a-book.com/figs/sd06.png" target="_blank"><img src="http://www.on-writing-a-book.com/figs/sd06s.png" alt="" /></a></p>
<p><a href="http://www.on-writing-a-book.com/figs/sd02.png" target="_blank"><img src="http://www.on-writing-a-book.com/figs/sd02s.png" alt="" /></a><a href="http://www.on-writing-a-book.com/figs/sd03.png" target="_blank"><img src="http://www.on-writing-a-book.com/figs/sd03s.png" alt="" /></a></p>
<p><a href="http://www.on-writing-a-book.com/figs/sd05.png" target="_blank"><img src="http://www.on-writing-a-book.com/figs/sd05s.png" alt="" /></a><a href="http://www.on-writing-a-book.com/figs/sd07.png" target="_blank"><img src="http://www.on-writing-a-book.com/figs/sd07s.png" alt="" /></a></p>
<p>You can get more details from the <a href="http://www.smartdraw.com/">SmartDraw</a> website. You can download a trial version of the software and see the features before buying it. You can choose the right business graphic using the <a href="http://smartdraw.com/encyclopedia/index.htm">Encyclopedia of Business Graphics</a>. You can read through the <a href="http://smartdraw.com/solutions/bulletins/index.htm">Business Graphics bulletins</a> with links to white papers, webinars, tutorials, success stories, and more at. You can learn more techniques and tips by studying the <a href="http://smartdraw.com/exp/ste/examples/">examples</a>. In addition to the above resources there are <a href="http://smartdraw.com/training/">step-by-step tutorials</a> for creating a perfect diagram in minutes.</p>
<p>SmartDraw is a must for every technical author as it will improve the productivity and also the quality of the images making the article, essay, or book more interesting and readable. I recommend it to all authors and technical writers.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.on-writing-a-book.com/2008/02/08/smartdraw.html/feed</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
	</channel>
</rss>

