<?xml version="1.0" encoding="UTF-8" ?>
<?xml-stylesheet type="text/xsl" href="http://forums.blackbaud.com/utility/FeedStylesheets/rss.xsl" media="screen"?><rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:slash="http://purl.org/rss/1.0/modules/slash/" xmlns:wfw="http://wellformedweb.org/CommentAPI/"><channel><title>From the Doc Side : Documentation</title><link>http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx</link><description>Tags: Documentation</description><dc:language>en</dc:language><generator>CommunityServer 2007 SP2 (Debug Build: 20611.960)</generator><item><title>Forget Best-Selling Audio Books, Listen to Our User Guides for Free!</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2009/10/20/forget-best-selling-audio-books-listen-to-our-user-guides-for-free.aspx</link><pubDate>Tue, 20 Oct 2009 14:08:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:45948</guid><dc:creator>Lindsey Robbins</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=45948</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2009/10/20/forget-best-selling-audio-books-listen-to-our-user-guides-for-free.aspx#comments</comments><description>Did you know you could listen to our user guides read out loud
for free? Well, if you have the free Adobe Acrobat Reader or even the full
Adobe Acrobat installed on your Windows computer you have the ability to not
only read our guides but listen to them as well. It&amp;#39;s a little known feature
that may be of use to you. 

&lt;p&gt;In Adobe Acrobat Reader, on the menu go to &lt;b&gt;View&lt;/b&gt;, &lt;b&gt;Read Out Loud&lt;/b&gt;. You can select to listen to the entire document or just
the page you are on. Adobe uses the basic Windows voice settings so if you aren&amp;#39;t
able to hear anything, go to your &lt;b&gt;Control
Panel&lt;/b&gt;, &lt;b&gt;Sound and Audio Devices&lt;/b&gt;, &lt;b&gt;Audio&lt;/b&gt; tab. On the Audio tab, ensure you
have a device selected for the sound playback. &lt;/p&gt;

&lt;p&gt;If you want to adjust the voice or playback speed for the
read out loud capability, go to &lt;b&gt;Control Panel&lt;/b&gt;, &lt;b&gt;Speech&lt;/b&gt;, &lt;b&gt;Text to Speech&lt;/b&gt; tab. I personally went with Microsoft Sam on my
computer, I like his deep monochromatic voice. If only they made a CP-30 voice.&lt;/p&gt;
&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=45948" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/suggestion/default.aspx">suggestion</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+assistance+content/default.aspx">user assistance content</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Acrobat+Reader/default.aspx">Acrobat Reader</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Reader/default.aspx">Reader</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Adobe+Acrobat/default.aspx">Adobe Acrobat</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/tools/default.aspx">tools</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+guides/default.aspx">user guides</category></item><item><title>Meet the Team - Steve S.</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2009/07/09/meat-the-team-steve-s.aspx</link><pubDate>Thu, 09 Jul 2009 18:05:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:42749</guid><dc:creator>Lindsey Robbins</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=42749</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2009/07/09/meat-the-team-steve-s.aspx#comments</comments><description>&lt;img src="http://www.apriliaforum.com/forums/attachment.php?attachmentid=91341&amp;amp;stc=1&amp;amp;d=1220151380" align="right" height="150" hspace="10" alt="" /&gt;&lt;b&gt;Name? &lt;/b&gt;Steve S.

&lt;p&gt;&lt;b&gt;How long have you been at Blackbaud&lt;/b&gt;? Going
on 4 years&lt;br /&gt;
&lt;b&gt;&lt;br /&gt;
What technology from the past do you wish would make a comeback?&lt;/b&gt; The &lt;a href="http://en.wikipedia.org/wiki/Flux_capacitor#Flux_Capacitor" target="_blank"&gt;flux capacitor&lt;/a&gt;... I could always use a little more time in
the day!&lt;/p&gt;

&lt;p&gt;&lt;b&gt;Favorite part of technical communication?&lt;/b&gt; Working
with multiple products, learning about new technology, and the adrenaline rush
and creative high that accompanies routine deadline doom.&lt;br /&gt;
&lt;b&gt;&lt;br /&gt;
&lt;/b&gt;&lt;img src="http://www.blackbaud.com/images/blogs/steves.jpg" align="left" height="400" hspace="10" alt="" /&gt;&lt;b&gt;Products you Work On?&lt;/b&gt; The Raiser&amp;#39;s Edge, Blackbaud Enterprise CRM, and Blackbaud
Payment Service&lt;br /&gt;
&lt;b&gt;&lt;br /&gt;
Other projects you Work On&lt;/b&gt;? PCI Compliance, usability,
consistency, and localization. I also cartoon for the company employee
newsletter, The Buzz.&lt;/p&gt;

&lt;p&gt;&lt;b&gt;How did you get into technical writing? &lt;/b&gt;My career as an indie comic book creator, while fun, didn&amp;#39;t
really pay the bills... Luckily, I was able to apply my talents as a technical
illustrator and then technical writer.&lt;/p&gt;

&lt;p&gt;&lt;b&gt;What&amp;#39;s changed about Blackbaud since you&amp;#39;ve been here?&lt;/b&gt; The CEO and the ever-growing headcount.&lt;br /&gt;
&lt;br /&gt;
&lt;b&gt;What hasn&amp;#39;t changed?&lt;/b&gt; The onsite fitness center remains the best perk I never use.&lt;br /&gt;
&lt;br /&gt;
&lt;b&gt;What&amp;#39;s one unique thing about you?&amp;nbsp;&lt;/b&gt; When
not working to meet deadlines at Blackbaud, I work to meet deadlines as the
staff cartoonist for the local alternative weekly newspaper.&lt;/p&gt;

&lt;p&gt;&lt;b&gt;Anything else? &lt;/b&gt;Nope.&lt;br /&gt;&lt;/p&gt;
&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=42749" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/technical+writer/default.aspx">technical writer</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/meet+the+team/default.aspx">meet the team</category></item><item><title>Twitter - Can it Make You a Better Technical Writer? </title><link>http://forums.blackbaud.com/blogs/documentation/archive/2009/04/16/twitter-can-it-make-you-a-better-technical-writer.aspx</link><pubDate>Thu, 16 Apr 2009 18:19:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:40746</guid><dc:creator>Steve Pham</dc:creator><slash:comments>1</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=40746</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2009/04/16/twitter-can-it-make-you-a-better-technical-writer.aspx#comments</comments><description>&lt;p&gt;Copyblogger&amp;#39;s Jennifer Blanchard thinks so and I&amp;nbsp;completely agree.&amp;nbsp; According to&amp;nbsp;the post &amp;quot;&lt;a href="http://www.copyblogger.com/twitter-writing/" class=""&gt;How Twitter Makes&amp;nbsp;You A Better Writer&lt;/a&gt;&amp;quot;,&amp;nbsp; Twitter helps writers in three ways: &lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;div&gt;Twitter forces you to be concise.&lt;/div&gt;&lt;/li&gt;
&lt;li&gt;
&lt;div&gt;Twitter forces you to exercise your vocabulary. &lt;/div&gt;&lt;/li&gt;
&lt;li&gt;
&lt;div&gt;Twitter forces you to improve your editing skills. &lt;/div&gt;&lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;Being fairly new to Twitter, I find myself constantly editing my tweets (the Twitter word for posts) to fit the 140 character limit.&amp;nbsp; Because of this limit, you do have to be careful about what and how you choose to write your messages. &lt;/p&gt;
&lt;p&gt;&lt;b&gt;How does Twitter force you to be concise?&lt;/b&gt;&lt;br /&gt;There is no getting around being brief. You write more than 140 characters, your message doesn&amp;#39;t get sent. You learn fast, capture the gist of what you want to say, and quickly send it out.&lt;br /&gt;&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Why do you need to exercise your vocabulary?&lt;/b&gt;&lt;br /&gt;If you only have 140 characters and have to be concise, you want to choose the most effective words to get your message across without using ones you don&amp;#39;t. So you start thinking about ways to say what you want with creative word choice and not extra sentences. Each word matters. When each word matters you think about them a lot more.&lt;br /&gt;&lt;/p&gt;
&lt;p&gt;&lt;b&gt;What&amp;#39;s editing have to do with anything? &lt;/b&gt;&lt;br /&gt;Because of being concise and evaluating each word choice, you often have to re-read your messages quite frequently to evaluate whether it&amp;#39;s what you meant to say. But, you don&amp;#39;t have all day to edit a tweet. Twitter forces you to write better in shorter amounts of time because a medium like this is all about being timely. The posts need to be fast yet good. You can&amp;#39;t compromise quality just because it&amp;#39;s a microblog. And, you want to send out good content that relfects well on the rest of your content and your skills. Editing well and quickly is of essence.&lt;br /&gt;&lt;/p&gt;
&lt;p&gt;&lt;b&gt;So how does this help technical writers? &lt;br /&gt;&lt;/b&gt;Well a good portion of help authoring is to deliver information as effectively and efficiently as possible so users can get back to the task they were trying to accomplish. Technical information isn&amp;#39;t prose or poetry. No one wants to read a book on how to turn on the computer. A tool like Twitter can make you aware of how important each word choice is but it can also teach you to get your message across sooner. As well, I find it encourages creativity in being effective. Creativity is always an important tool in staying relevant in technical communication as well as learn how to meet your users&amp;#39; needs with less space and words. People want help with their problem now and then to move on. Twitter is great then for teaching technical writers to focus on one problem or message and quickly move onto the next task. What do you think? Do you agree? Or, do you think tools and mediums like Twitter are ruining the English language? &lt;br /&gt;&lt;/p&gt;&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=40746" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/technical+communication/default.aspx">technical communication</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/technical+writer/default.aspx">technical writer</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/editing/default.aspx">editing</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+assistance+content/default.aspx">user assistance content</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/professional+development/default.aspx">professional development</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/web+2.0/default.aspx">web 2.0</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/twitter/default.aspx">twitter</category></item><item><title>Have you committed a technical writing sin?</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2009/03/27/have-you-committed-a-technical-writing-sin.aspx</link><pubDate>Fri, 27 Mar 2009 19:40:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:40315</guid><dc:creator>Steve Pham</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=40315</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2009/03/27/have-you-committed-a-technical-writing-sin.aspx#comments</comments><description>&lt;p&gt;I’ve been re-reading some old posts in the field, and after reading Amy Hoy&amp;#39;s Slash7 post on &amp;quot;&lt;a href="http://slash7.com/articles/2006/11/15/tech-writing-the-five-sins" target="_blank"&gt;How Tech Writing Sucks: The Five Sins&lt;/a&gt;,&amp;quot; I started thinking… is it really possible not to commit any one of the five sins? &lt;/p&gt;&lt;p&gt;&lt;b&gt;&lt;u&gt;The Five Sins - &lt;/u&gt;&lt;/b&gt;&lt;br /&gt;&lt;/p&gt;&lt;ol&gt;&lt;li&gt;Losing the reader&lt;/li&gt;&lt;li&gt;Making the reader feel stupid &lt;/li&gt;&lt;li&gt;Failing to stick&lt;/li&gt;&lt;li&gt;Being a total bore&lt;/li&gt;&lt;li&gt;Not providing much-needed context&lt;/li&gt;&lt;/ol&gt;&lt;p&gt;Hoy says the five sins are results of &amp;quot;bad&amp;quot; writing, but can you realistically prevent these things from happening for all users? As a n00bie in the field, I’m learning how to ensure the reader is getting what she needs out of the documentation. One objective of documentation is… user needs help, refer user to a guide or help file, user resolves issue on her own, and in doing so, saves user time and a phone call to customer support. Pretty simple... the objective at least seems that way, but now comes the tricky part.&lt;/p&gt;&lt;blockquote&gt;&lt;p&gt;&lt;b&gt;How do you keep the reader engaged with relevant, lively content, without feeling stupid, so she can remember it the next time she completes the process?&lt;/b&gt;&lt;/p&gt;&lt;/blockquote&gt;&lt;p&gt;Seems straight forward, but then again, we are discussing user guides and help files. These materials aren’t usually opened unless there is an issue, and then they are closed as soon as the issue is resolved. I guess what I am proposing is, these sins are sometimes inevitable. Here’s why…&lt;/p&gt;&lt;ul&gt;&lt;li&gt;You will lose the reader as soon as the issue is resolved. &lt;/li&gt;&lt;li&gt;No matter how you write, you’re going to make some reader feel stupid – either talking above or below them. &lt;/li&gt;&lt;li&gt;Most of the time, the content users are looking for is not everyday occurrences. Failing to stick is predictable and they will have to search for the answer again.&lt;/li&gt;&lt;li&gt;No matter how pretty you make it look, technical documentation is not going to be the most exciting type of reading available. How many manuals have ended up on the bestseller’s list? &lt;/li&gt;&lt;li&gt;Can you document everything? Probably not. So anytime a user cannot find something she is looking for, she is going to find it lacking.&lt;/li&gt;&lt;/ul&gt;&lt;p&gt;I understand we are supposed to write in a way that best prevents this from happening, but perhaps it’s just the nature of the beast. You can’t expect to satisfy everyone can you? But I bet you can expect to commit one of these &amp;quot;sins.” What do you think? Can we strive for and achieve sin-free technical content? And if not, is it good enough to learn from our mistakes and keep improving as we go along? &lt;br /&gt;&lt;/p&gt;&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=40315" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/technical+communication/default.aspx">technical communication</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/technical+writer/default.aspx">technical writer</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/suggestion/default.aspx">suggestion</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+assistance+content/default.aspx">user assistance content</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/conversations/default.aspx">conversations</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Help/default.aspx">Help</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+guides/default.aspx">user guides</category></item><item><title>How do you explain technical writing to a kid?</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2009/02/24/how-do-you-explain-technical-writing-to-a-kid.aspx</link><pubDate>Tue, 24 Feb 2009 16:51:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:39717</guid><dc:creator>Lindsey Robbins</dc:creator><slash:comments>2</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=39717</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2009/02/24/how-do-you-explain-technical-writing-to-a-kid.aspx#comments</comments><description>&lt;p&gt;The short answer is… you don’t! &lt;img src="http://forums.blackbaud.com/emoticons/emotion-2.gif" alt="Big Smile" /&gt;&lt;/p&gt;&lt;p&gt;Last Friday, I had the distinct privilege to be part of a special field trip for kids from Meeting Street Academy (See Rachel’s &lt;a href="http://forums.blackbaud.com/blogs/philanthropy/archive/2009/02/20/reasons-to-believe-are-all-around-us.aspx" target="_blank"&gt;blog post&lt;/a&gt; for more background on the special event). In short summary, I was to explain to four and five year olds what I do for a living. Hmmm… technical writing in the eyes of a child. &lt;/p&gt;&lt;p&gt;Here are some things I thought of…&amp;nbsp; (and yes, please feel free to laugh at my feeble attempt)&lt;br /&gt;&lt;/p&gt;&lt;ol&gt;&lt;li&gt;Do you like to read? &lt;/li&gt;&lt;li&gt;What books?&lt;/li&gt;&lt;li&gt;Do you like to make up stories?&lt;/li&gt;&lt;li&gt;Do you like playing on the computer?&lt;/li&gt;&lt;li&gt;Add that all up and you can be me! &lt;/li&gt;&lt;/ol&gt;&lt;p&gt;See in my mind, I was trying to explain how a kid their age who loved reading and stories somehow became me as an adult with this career that involves playing with things and writing about it. I even showed them the *books* we write and how they have pictures (screen captures).&lt;/p&gt;&lt;p&gt;I really wanted to explain how curiosity was important in my education and career but wasn&amp;#39;t exactly sure how. However, I think in general I was supposed to show them that it’s important to read, to learn how to write, and to stay in school. I loved how they liked to raise their hands to ask questions, that’s a good sign! Being eager to learn is definitely a part of technical writing. &lt;/p&gt;&lt;p&gt;I’ve given plenty of talks about technical writing before (to college age kids) but this experience gave me a chance to see what I do through the eyes of a child. And, I laughed. It’s not exactly possible but I think just seeing someone who has a job they love and enjoy is important. I hope they continue to see positive examples of people who applied their learning to a cool career. If one of them happens to take on technical communication, all the cooler.&lt;/p&gt;&lt;p&gt;How would you explain your profession to a child? &lt;br /&gt;&lt;/p&gt;&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=39717" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/technical+communication/default.aspx">technical communication</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/technical+writer/default.aspx">technical writer</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category></item><item><title>How can we produce effective yet efficient user assistance content?</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2009/02/02/how-to-produce-effective-yet-efficient-user-assistance-content.aspx</link><pubDate>Mon, 02 Feb 2009 18:25:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:39205</guid><dc:creator>Lindsey Robbins</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=39205</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2009/02/02/how-to-produce-effective-yet-efficient-user-assistance-content.aspx#comments</comments><description>&lt;p&gt;One of my esteemed co-workers shared this awesome article with me last week and now I want to share it with other writers of user assistance content in the field. If you haven’t read it yet, Mike Hughes’ article &lt;a href="http://www.uxmatters.com/mt/archives/2009/01/straight-talk-surviving-tough-times-as-a-user-assistance-writer.php" target="_blank"&gt;&lt;i&gt;&lt;b&gt;Straight Talk: Surviving Tough Times as a User Assistance Writer&lt;/b&gt;&lt;/i&gt;&lt;/a&gt; is a great read and quite thought-provoking. When I can squeeze in some time, I really want to thoroughly read it and make some notes about his main article points. There is a lot to digest in his post.&lt;/p&gt;&lt;p&gt;It came at a great time for me as I’m learning our team’s updated writing style. I’m learning how we’re tackling one of the article’s main points, how do you keep improving your user assistance content to meet audience needs while also being efficient with your resources and time?&lt;/p&gt;&lt;p&gt;Hope you enjoy the article!&lt;br /&gt;&lt;br /&gt;&lt;/p&gt;&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=39205" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/suggestion/default.aspx">suggestion</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+assistance+content/default.aspx">user assistance content</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/professional+development/default.aspx">professional development</category></item><item><title>Developing Trust in Help Content</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2009/01/13/documentation.aspx</link><pubDate>Tue, 13 Jan 2009 19:48:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:38780</guid><dc:creator>Lindsey Robbins</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=38780</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2009/01/13/documentation.aspx#comments</comments><description>&lt;p&gt;One topic I am reading about, that I missed the discussion on over holiday break, is all this talk about whether people trust blogs on corporate websites. While I really don’t know where to put my two cents in about trust and corporate blogs (because I mostly write this blog just to interact with our users more), it did get me thinking about how you develop your ethos overall. In particular, I thought about how people learn to trust or not to trust documentation. Does it all depend on your first interaction when you search for help? Do you give up if you don’t find something on the first try? How do you decide whether you should trust the help content you are reading?&lt;/p&gt;&lt;p&gt;I know many times, depending on the product, my help file is an internet search on &lt;a href="http://www.google.com" target="_blank"&gt;Google.com&lt;/a&gt; (scandalous coming from a technical writer, right?!). For some products, I trust the users more than the bare minimum, hard to find documentation.&lt;/p&gt;&lt;p&gt;However, I have read some product documentation and you can tell when the writers put in effort to be correct. I suppose that’s why I also like to blog, you get to be more transparent and ask for feedback. It’s why we do our &lt;a href="http://vovici.com/wsb.dll/s/f87eg28e24" target="_blank"&gt;survey&lt;/a&gt; too. We know you aren’t always going to find your answer on the first try, but because we care about your trust in us, we want to listen and improve. So if you ever want to tell us how we can earn/improve your trust in us, we’d be glad to spend some time hearing what you have to say. Then, it’s not asking for trust, it’s earning it bit by bit in our behavior on an everyday basis. &lt;img src="http://forums.blackbaud.com/emoticons/emotion-2.gif" alt="Big Smile" /&gt;&lt;/p&gt;&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=38780" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+assistance+content/default.aspx">user assistance content</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/feedback/default.aspx">feedback</category></item><item><title>User-Generated Help: Future of Documentation?</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2008/11/26/user-generated-help-future-of-documentation.aspx</link><pubDate>Wed, 26 Nov 2008 18:07:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:38266</guid><dc:creator>Lindsey Robbins</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=38266</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2008/11/26/user-generated-help-future-of-documentation.aspx#comments</comments><description>&lt;p&gt;Of late, I’ve been intrigued by something &lt;a href="http://www.youtube.com" target="_blank"&gt;&lt;b&gt;YouTube&lt;/b&gt;&lt;/a&gt; is doing. They are requesting user-submitted documentation in the form of videos. Well the video part makes sense, right? However, it’s interesting they are reaching out to the audience to supplement their official documentation. Is it fair to put the burden on the users? Fun for users to participate in developing help?&lt;/p&gt;&lt;p&gt;They are now doing a second round of submissions. You can read about it in &lt;a href="http://www.youtube.com/blog?entry=IRdk88cu3GY" target="_blank"&gt;their blog&lt;/a&gt;.&amp;nbsp; And, you can review the &lt;a href="http://www.youtube.com/blog?entry=IRdk88cu3GY" target="_blank"&gt;round one selections&lt;/a&gt;.&lt;/p&gt;&lt;p&gt;One interesting thing, they didn’t ask for just any help submission, they provided a list of topics to choose from. If your video is selected, it is then posted side-by-side with their content. And, they claim their help gets 1 million + users a day. Not sure if I believe that or not but it’s still interesting (I&amp;#39;ve never clicked on the their help but maybe I&amp;#39;m an anomaly).&lt;br /&gt;&lt;/p&gt;&lt;p&gt;This is definitely a topic I’ll keep my eye on as help and documentation might be figuring out how to join the web 2.0 world. But then the question still remains, when do you ask for user-generated help? I mean, it might be a pure guess on my part but I don&amp;#39;t see a million people rushing to create help content. Most people would rather visit the dentist then spend time explaining things to others. Unless you&amp;#39;re like me. And if you are, welcome to my &lt;strike&gt;crazy&lt;/strike&gt; cool world.&lt;/p&gt;&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=38266" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+assistance+content/default.aspx">user assistance content</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/emerging+technology/default.aspx">emerging technology</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/web+2.0/default.aspx">web 2.0</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Help/default.aspx">Help</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/humor/default.aspx">humor</category></item><item><title>Have a Helpful Idea?</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2008/11/20/have-a-helpful-idea.aspx</link><pubDate>Thu, 20 Nov 2008 18:56:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:38149</guid><dc:creator>Lindsey Robbins</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=38149</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2008/11/20/have-a-helpful-idea.aspx#comments</comments><description>&lt;p&gt;Your suggestions are heard. Yes, I know it can be hard to believe sometimes but some people (finger pointing at me and the rest of Blackbaud) love to listen. Listening is fun because you don’t have to pretend to know everything. You can let others share their unique experiences, thoughts, and visions with you. And then as Shaun Sullivan said, steal it as your own genius idea. Okay, I don’t think I really have the guts to claim credit from anyone (and I&amp;#39;m pretty sure he was joking) but I do dig hearing other people’s ideas and researching them further.&lt;/p&gt;&lt;p&gt;In fact, a bunch of our technical writers were sitting in Shaun’s Emerging Technology session at Blackbaud’s Conference for Nonprofits this past Monday and listening. He was discussing how you can search the Infinity apps and how it intelligently provides results including an index of our help. And a great question was asked… &lt;i&gt;Can you pull in a 3rd party help to be indexed as well&lt;/i&gt;?&lt;/p&gt;&lt;p&gt;&lt;b&gt;Hmmm… good idea!&lt;/b&gt;&lt;/p&gt;&lt;p&gt;As our senior technical writer said in the session, we’ll look into it. And let me say, I’m pretty sure we’ll have some great discussions and research about it. Either way, I want to acknowledge that the question was great!&lt;/p&gt;&lt;p&gt;&lt;b&gt;So what’s the point?&lt;/b&gt;&lt;/p&gt;&lt;p&gt;I just wanted the opportunity to say we’d love for you to share any other ideas you have. None are bad. All ideas, even in the most basic form, can be sparks for improvement, conversations, and even other ideas. To submit a good idea, leave a comment on the post (&lt;a href="http://www.blackbaud.com/profile/logon.aspx?ReturnUrl=http%3a%2f%2fforums.blackbaud.com%2fblogs%2fchatterbox%2fdefault.aspx" target="_blank"&gt;login&lt;/a&gt; or &lt;a href="http://www.blackbaud.com/forumlogin.aspx" target="_blank"&gt;register for free&lt;/a&gt; in the upper right corner) or email us anytime at &lt;a href="mailto:documentationcomments@blackbaud.com" target="_blank"&gt;documentationcomments@blackbaud.com&lt;/a&gt;.&lt;/p&gt;&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=38149" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/feedback/default.aspx">feedback</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/emerging+technology/default.aspx">emerging technology</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/communication/default.aspx">communication</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/conversations/default.aspx">conversations</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Help/default.aspx">Help</category></item><item><title>Journey from Structred Frame to SharePoint Server Wiki</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2008/11/18/journey-from-structred-frame-to-sharepoint-server-wiki.aspx</link><pubDate>Tue, 18 Nov 2008 11:36:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:38060</guid><dc:creator>Lindsey Robbins</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=38060</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2008/11/18/journey-from-structred-frame-to-sharepoint-server-wiki.aspx#comments</comments><description>&lt;p&gt;The journey from last week to this week already feels a decade long as I’ve encountered many trials and errors in converting internal team documentation authored in Structured FrameMaker into a Microsoft SharePoint Server 2007 friendly format. In other words, complex framemaker to basic html.&lt;/p&gt;&lt;p&gt;I’m not complaining about the trials and errors. On the contrary, it’s been exciting to dig my hands into this fun little side project that keeps evolving and building.&lt;/p&gt;&lt;p&gt;Well really, I need to take you back three years to get to the root of where I’m at now. It all started with two separate projects. The first started as learning about how we generate help from Adobe FrameMaker using WebWorks and my lesson was our internal documentation help file&lt;i&gt; the Tech Writer Master&lt;/i&gt;. Sounds intimidating doesn’t it? I spent a lot of time updating, organizing, and examining the information design of the help file. Unfortunately, a problem we frequently faced was there wasn’t an easy way to quickly and efficiently update the internal documentation. And as you know, processes, workflows, and general daily work information is fluid and changes often. So I kept the internal documentation as an interest especially because of my passion for knowledge management.&lt;/p&gt;&lt;p&gt;Then that summer, I was tasked along with another co-worker to research how we might, and whether it was valuable, implement our help file as a wiki. We ended up going a different direction with our Infinity help but I was able to bring in my wiki experience and often ask myself what role wikis could have in user assistance content. When the wiki project ran its course, I kept up with the free wiki tools out there and wanted to find a way to install on my own machine and run as a web server for my team. I knew ultimately that having the Documentation team work on a wiki would provide valuable experience in new ways of thinking about content management.&lt;/p&gt;&lt;p&gt;Months went by and my company rolled out Microsoft SharePoint Server 2007 as our internal company content management system.&amp;nbsp; I knew SharePoint had some wiki capabilities but I had to test it and see if it could work for us. I ended up choosing a Wiki Site from their templates. I played with it and in a matter of days, I had a team wiki set up.&amp;nbsp; It wasn’t perfect, didn’t have all the features I wanted (especially around navigation), and proved frustrating at times but I was able to get the basics of what I needed up and going. And once it was set up, I presented it to my manager who pushed me to present it to the team.&lt;br /&gt;&lt;/p&gt;&lt;p&gt;So now, a few months after my team presentation, my little baby project is growing and providing new challenges. Our team is in the process of implementing it and that means gathering content from everywhere it’s been spread out and organizing it on the wiki. Which brings me to the conversion of docs from FrameMaker to HTML.&lt;/p&gt;&lt;p&gt;I tried a couple different methods before deciding on a winner -&lt;br /&gt;&lt;/p&gt;&lt;ul&gt;&lt;li&gt;FrameMaker to PDF. From PDF, save file as html.&amp;nbsp;&lt;b&gt; Issue:&lt;/b&gt; Formatting errors especially concerning images. Would involve too much cleanup.&lt;/li&gt;&lt;li&gt;FrameMaker, save as XML. XML to HTML using an XSL stylesheet.&lt;b&gt; Issue:&lt;/b&gt; Worked sorta, but it would take a long time to convert and would need to spend some time creating a style sheet that fit our wiki needs.&lt;/li&gt;&lt;li&gt;&lt;b&gt;Winner:&lt;/b&gt; I ended up using a basic WebWorks dynamic html template to generate one html file per FrameMaker chapter. I quickly chose the mapping for the Source to WebWorks style but after a few times choosing the styles, I quickly figured out what I wanted for the output. In some cases, I was able to eliminate some formatting later on by choosing not to output certain Frame items. I still had to do some cleanup but mainly that was around cross-references and updating the file paths to the images.&lt;/li&gt;&lt;/ul&gt;&lt;p&gt;While there is still some manual cleanup in generating the html files, I am glad to have a pretty easy process to get our current documentation into the wiki. And, I even have a new member of my team helping with the setup of the wiki. Between him and I, we’re going to get our team’s content up, properly formatted, and perhaps even some consistency in the style of the content.&lt;/p&gt;&lt;p&gt;My hope, &lt;i&gt;&lt;b&gt;start 2009 with our knowledge management system in place and ready to be updated in real time&lt;/b&gt;&lt;/i&gt;. To say I’m excited is an understatement. It’s pretty cool to turn an idea into a reality.&lt;/p&gt;&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=38060" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/technical+communication/default.aspx">technical communication</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+assistance+content/default.aspx">user assistance content</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/emerging+technology/default.aspx">emerging technology</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/wikis/default.aspx">wikis</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/PDF/default.aspx">PDF</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/tools/default.aspx">tools</category></item><item><title>What Do Users Need?</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2008/11/06/what-do-users-need.aspx</link><pubDate>Thu, 06 Nov 2008 19:09:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:37926</guid><dc:creator>Lindsey Robbins</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=37926</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2008/11/06/what-do-users-need.aspx#comments</comments><description>&lt;p&gt;A simple question. What do users need? My mind starts thinking
about it and I realize there are just too many answers to mentally fathom. Recently, someone on my team shared a great link to discussion results from a
recent CIDM conference.&lt;/p&gt;


&lt;p&gt;&amp;nbsp;&lt;a href="http://www.infomanagementcenter.com/enewsletter/200811/third.htm" target="_blank"&gt;http://www.infomanagementcenter.com/enewsletter/200811/third.htm&lt;/a&gt;&lt;/p&gt;


&lt;p&gt;I thought the &amp;quot;What we learned&amp;quot; section contained a lot of
great answers. Seems thorough but of course it can never be a complete list.
Users&amp;#39; needs are ever evolving and ever changing.&lt;/p&gt;

&lt;p&gt;However, one particular statement I&amp;#39;ve thought about before came
up in the discussion.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;
&lt;b&gt;Users need answers to &lt;i&gt;their&lt;/i&gt; questions.&lt;/b&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Obvious - Yes. Easy to execute - No. How can you ever
provide all the answers to each individual&amp;#39;s questions? The answer is you probably
can&amp;#39;t but you try to answer as many as you can and provide ways to answer the
rest by other means.&lt;/p&gt;

&lt;p&gt;In Documentation, we recognize that while we aim to help
every single user, there are times where your particular situation calls for
Knowledgebase or Customer Support. However, that doesn&amp;#39;t stop us from trying.
Your questions always provide us opportunities to improve our Help.&lt;/p&gt;

&lt;p&gt;Here are the main lessons learned from the article...&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Answer the users&amp;#39; questions and help them do
their job.&lt;/li&gt;

&lt;li&gt;Make it easy for users to find the answer.&lt;/li&gt;

&lt;li&gt;Provide users access or links to related
information.&lt;/li&gt;

&lt;li&gt;Give users an easy forum for reporting issues
and collaborating.&lt;/li&gt;

&lt;li&gt;Give users information in a format that suits
their work environment.&lt;/li&gt;

&lt;li&gt;Technology is changing user expectations.&lt;/li&gt;
&lt;/ol&gt;
What do you think, does this sound accurate?

&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=37926" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+assistance+content/default.aspx">user assistance content</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/feedback/default.aspx">feedback</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Help/default.aspx">Help</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+research/default.aspx">user research</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/usability/default.aspx">usability</category></item><item><title>Vintage Documentation</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2008/10/31/vintage-documentation.aspx</link><pubDate>Fri, 31 Oct 2008 14:52:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:37812</guid><dc:creator>Lindsey Robbins</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=37812</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2008/10/31/vintage-documentation.aspx#comments</comments><description>&lt;p&gt;Wired magazine published a great photo essay on classic instruction manuals.&amp;nbsp; It’s funny and pretty cool to see how far we’ve come as a field. Although my team is in agreement, that poor guy from Apple - what was he thinking selling his share of Apple stock for $800?!&lt;/p&gt;&lt;p&gt; Check out the photo essay here:&lt;br /&gt;&lt;a href="http://www.wired.com/culture/design/multimedia/2008/10/ff_manuals" target="_blank"&gt;http://www.wired.com/culture/design/multimedia/2008/10/ff_manuals&lt;/a&gt;&lt;/p&gt;&lt;p&gt;&amp;nbsp;&lt;img src="http://www.wired.com/images/article/magazine/1611/ff_manuals10_f.jpg" width="232" height="290" hspace="5" alt="" /&gt;&lt;/p&gt;&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=37812" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/humor/default.aspx">humor</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+guides/default.aspx">user guides</category></item><item><title>Documentation Survey 3rd Quarter Results</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2008/10/27/documentation-survey-3rd-quarter-results.aspx</link><pubDate>Mon, 27 Oct 2008 14:37:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:37712</guid><dc:creator>Lindsey Robbins</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=37712</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2008/10/27/documentation-survey-3rd-quarter-results.aspx#comments</comments><description>&lt;p&gt;On October 9th, &lt;a href="http://forums.blackbaud.com/blogs/documentation/archive/2008/10/09/3rd-quarter-documentation-survey-winner.aspx" target="_blank"&gt;Justin announced&lt;/a&gt; our third quarter &lt;a href="http://vovici.com/wsb.dll/s/f87eg28e24" target="_blank"&gt;documentation survey&lt;/a&gt; winner. I thought it might be nice to discuss some of our results from the survey with our blog readers. &lt;/p&gt;
&lt;p&gt;A link to our survey appears on the Blackbaud User Guides pages (accessed from the Support menu), this blog, EE/FE/SIS Help files (a test run), and in the support newsletters once each quarter. We received 73 responses in Q3 2008.&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Overall Key Findings:&lt;/b&gt;&lt;br /&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;For our five overall rating categories – Accuracy, Completeness, Easy to Understand, Accessibility, and Usefulness – the most frequent rating was a 4 or 5 (out of 5).&lt;/li&gt;
&lt;li&gt;Our best overall rating category was Accuracy. Out of 73 responses, 62 rated us 4 or 5. &amp;nbsp;&lt;/li&gt;
&lt;li&gt;72.6% of survey respondents were able to find the answer to their question in the documentation the last time they accessed it.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;b&gt;Question: Please give an overall rating for the following aspects of documentation (user guides and help files only) on a scale of 1 (least favorable) to 5 (most favorable)?&lt;/b&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src="http://www.blackbaud.com/images/blogs/95587_167460.jpg" width="700" height="400" alt="" /&gt;&lt;br /&gt;&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Discussion&lt;/b&gt;:&lt;br /&gt; While we are pleased our numbers are mostly 4’s and 5’s we are actively looking for opportunities to improve and we even received some great suggestions from the open ended responses on the survey. &lt;/p&gt;
&lt;p&gt;&lt;b&gt;Question: Which Blackbaud product were you using when you accessed the documentation (user guides and help files)?&lt;/b&gt;&lt;/p&gt;

&lt;table&gt;
	&lt;tr&gt;
		&lt;td&gt;&lt;b&gt;Product&lt;/b&gt;&lt;/td&gt;
		&lt;td&gt;&lt;b&gt;Responses&lt;/b&gt;&lt;/td&gt;
		&lt;td&gt;&lt;b&gt;Percentage&lt;/b&gt;&lt;/td&gt;
	&lt;/tr&gt;
	&lt;tr&gt;
		&lt;td&gt;The Raiser&amp;#39;s Edge&lt;/td&gt;
		&lt;td&gt;51&lt;/td&gt;
		&lt;td&gt;69.9%&lt;/td&gt;
	&lt;/tr&gt;
	&lt;tr&gt;
		&lt;td&gt;The Financial Edge&lt;/td&gt;
		&lt;td&gt;11&lt;/td&gt;
		&lt;td&gt;15.1%&lt;/td&gt;
	&lt;/tr&gt;
	&lt;tr&gt;
		&lt;td&gt;The Education Edge&lt;/td&gt;
		&lt;td&gt;4&lt;/td&gt;
		&lt;td&gt;5.5%&lt;/td&gt;
	&lt;/tr&gt;
	&lt;tr&gt;
		&lt;td&gt;BSIS&lt;/td&gt;
		&lt;td&gt;1&lt;/td&gt;
		&lt;td&gt;1.4%&lt;/td&gt;
	&lt;/tr&gt;
	&lt;tr&gt;
		&lt;td&gt;BBNC&lt;/td&gt;
		&lt;td&gt;5&lt;/td&gt;
		&lt;td&gt;6.8%&lt;/td&gt;
	&lt;/tr&gt;
	&lt;tr&gt;
		&lt;td&gt;The Patron Edge&lt;/td&gt;
		&lt;td&gt;1&lt;/td&gt;
		&lt;td&gt;1.4%&lt;/td&gt;
	&lt;/tr&gt;
	&lt;tr&gt;
		&lt;td&gt;The Information Edge&lt;/td&gt;
		&lt;td&gt;0&lt;/td&gt;
		&lt;td&gt;0.0%&lt;/td&gt;
	&lt;/tr&gt;
	&lt;tr&gt;
		&lt;td&gt;BBDM&lt;/td&gt;
		&lt;td&gt;0&lt;/td&gt;
		&lt;td&gt;0.0%&lt;/td&gt;
	&lt;/tr&gt;
	&lt;tr&gt;
		&lt;td&gt;ResearchPoint&lt;/td&gt;
		&lt;td&gt;0&lt;/td&gt;
		&lt;td&gt;0.0%&lt;/td&gt;
	&lt;/tr&gt;
&lt;/table&gt;

&lt;p&gt;&lt;b&gt;Discussion&lt;/b&gt;: While we are always pleased with the number of responses for &lt;b&gt;&lt;i&gt;The Raiser’s Edge&lt;/i&gt;&lt;/b&gt;, we are looking for ways to improve the amount of feedback we receive for our other products. While we know we don’t have as many users on &lt;i&gt;&lt;b&gt;The Patron Edge&lt;/b&gt;&lt;/i&gt; as &lt;b&gt;&lt;i&gt;The Raiser&amp;#39;s Edge&lt;/i&gt;&lt;/b&gt;, we value each user’s feedback equally.&lt;b&gt;&lt;/b&gt;&lt;/p&gt;&lt;p&gt;&lt;b&gt;Question: The last time you had a question, did you find the answer in the documentation (user guides and help files)?&lt;/b&gt;&lt;/p&gt;&lt;p&gt;&lt;img src="http://www.blackbaud.com/images/blogs/95587_167461.jpg" alt="" /&gt;&lt;br /&gt;&lt;/p&gt;&lt;p&gt;&lt;b&gt;Discussion:&lt;/b&gt; We are happy to have so many “yes” answers to this question. We hope it means you find your answer quickly and get back to completing your tasks. However, we also see that 27.4% of you did not find your answer. This question is one of our critical ones. We’d love for to you always find your answer. Our numbers have been improving in this category but there is always more room for improvement. &lt;br /&gt;&lt;/p&gt;&lt;p&gt;Here are some&lt;b&gt; sample user comments and suggestions&lt;/b&gt; pulled from the survey (only initials to protect the privacy of our clients): &lt;br /&gt;&lt;br /&gt;User guides are enormous. Small, more streamlined versions, maybe for more discrete tasks would be helpful. I frequently find myself selectively printing only the relevant sections of a guide.&lt;br /&gt;&lt;b&gt;TH&lt;/b&gt;&lt;br /&gt;&lt;br /&gt;The user guides are easy to understand and are helpful. I like being able to find an answer without having to call customer support.&lt;br /&gt;&lt;b&gt;JH&lt;/b&gt;&lt;br /&gt;&lt;br /&gt;Love the support offered by Blackbaud, especially easy access to the User Guides - don&amp;#39;t have to buy a hard copy, and don&amp;#39;t have to deal with free documentation that is purposely incomplete in effort to get me to buy the manual! Good job Blackbaud. Always happy to recommend your company.&lt;br /&gt;&lt;b&gt;AB&lt;/b&gt;&lt;br /&gt;&lt;br /&gt;Your User Guides are very extensive and frequently help me answer my questions. However, &lt;br /&gt;sometimes when searching I get results that are not dealing with the program I specified.&lt;br /&gt;&lt;b&gt;JF&lt;/b&gt;&lt;br /&gt;&lt;br /&gt;I especially like the guides when I want an initial overview of the module. They are well organized and explain the technical aspects very clearly.&lt;br /&gt;&lt;b&gt;MT&lt;/b&gt;&lt;/p&gt;&lt;p&gt;&lt;b&gt;Discussion:&lt;/b&gt; I think the open ended comments are my favorite part of the survey. It&amp;#39;s not easy to quantify the information but hearing exactly what you think is critical. And, we take what you say to heart. If you allow us too, we try to follow up with as many people as possible especially when they offer up suggestions, areas for improvements, or mention problems. For example, to the user who mentioned the guides are enormous we would try to see if it would have been better for the user to search for the answer in the help file versus the user guides. Sometimes it can be a matter of choosing the right resource in the situation. And, we do realize that we are unable to help every user every time because there can be situations when contacting the help desk is the right decision. &lt;br /&gt;&lt;/p&gt;&lt;p&gt;Thanks again to our Q3 survey respondents! &lt;b&gt;And remember, if you take &lt;a href="http://vovici.com/wsb.dll/s/f87eg28e24" target="_blank"&gt;our survey&lt;/a&gt;, every quarter we enter the respondents into a drawing for a $25 Amazon.com gift card. &lt;/b&gt;&lt;br /&gt;&lt;/p&gt;&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=37712" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/survey/default.aspx">survey</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/online+survey/default.aspx">online survey</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/feedback/default.aspx">feedback</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/usability/default.aspx">usability</category></item><item><title>By Popular Demand - The Raiser's Edge 7 for Beginners</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2008/10/23/by-popular-demand.aspx</link><pubDate>Thu, 23 Oct 2008 17:40:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:37278</guid><dc:creator>Steve Stegelin</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=37278</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2008/10/23/by-popular-demand.aspx#comments</comments><description>&lt;p&gt;&lt;img src="http://www.blackbaud.com/files/support/guides/re7ent/re7begin.gif" style="width:360px;height:322px;" align="right" border="0" width="360" height="322" hspace="9" alt="" /&gt;We often get great feedback about our documentation from our users.&amp;nbsp; Sometimes, it&amp;#39;s a friendly head&amp;#39;s up of a typo that made its way out into the world (d&amp;#39;oh!).&amp;nbsp; My favorites, though, are when I get to help fulfill a user’s request or search for information by introducing them to a guide they simply weren’t aware existed. Let’s face it, there’s a lot in &lt;b&gt;&lt;i&gt;The Raiser’s Edge&lt;/i&gt;&lt;/b&gt;, and as such, there are plenty of guides to browse through (and glance over along the way). &lt;/p&gt;
&lt;p&gt;&lt;br /&gt;So it was often frustrating to get that one request I couldn’t answer so easily:&amp;nbsp; The request for the “one guide” that introduces the user to everything &lt;b&gt;&lt;i&gt;The Raiser’s Edge&lt;/i&gt;&lt;/b&gt; has to offer. A simple overview, painted in broad strokes, something for a novice user. Of course this was an obvious need—like I said, there’s a lot in &lt;b&gt;&lt;i&gt;The Raiser’s Edge&lt;/i&gt;&lt;/b&gt;—and the lack of a good answer was always the most frustrating.&amp;nbsp;&lt;/p&gt;
&lt;p&gt;&lt;br /&gt;So it’s with much pleasure to finally have an answer to that request with &lt;i&gt;The Raiser’s Edge 7 for Beginners&lt;/i&gt;. It’s full of great, useful information, ideal for both the new users struggling with the daunting task of having to grasp everything &lt;b&gt;&lt;i&gt;The Raiser’s Edge&lt;/i&gt;&lt;/b&gt; offers and the experienced users looking to refresh their memories or explore other areas of the program. It’s also unlike any other user guide we provide for &lt;b&gt;&lt;i&gt;The Raiser’s Edge&lt;/i&gt;&lt;/b&gt;. Here’s an excerpt:&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;br /&gt;After you use the program for awhile, you will probably discover other navigation features and methods. Use the ones that work best for you. No way of navigating is necessarily right and no way is necessarily wrong; it’s a you say “potayto,” I say “potahto” kind of thing. Well, actually I usually just say “French fries,” but you get the idea.&lt;/p&gt;&lt;/blockquote&gt;
&lt;p&gt;&lt;br /&gt;Written in this humorous, lighthearted, and simplistic style (not to suggest anyone’s a &lt;i&gt;Dummy&lt;/i&gt;), it covers the wide range of features available in &lt;b&gt;&lt;i&gt;The Raiser’s Edge&lt;/i&gt;&lt;/b&gt;, from records to queries, from reports to mail, and everything in between.&amp;nbsp; You can find it &lt;a href="http://www.blackbaud.com/support/guides/re7.aspx#start" class="" target="_blank"&gt;here&lt;/a&gt;. (And now I can’t wait for the time a user requests the “one guide” that introduces everything &lt;b&gt;&lt;i&gt;The Raiser’s Edge&lt;/i&gt;&lt;/b&gt; has to offer!)&lt;br /&gt;&lt;/p&gt;&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=37278" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/technical+communication/default.aspx">technical communication</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+assistance+content/default.aspx">user assistance content</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/user+guides/default.aspx">user guides</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/The+Raiser_2700_s+Edge/default.aspx">The Raiser's Edge</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/RE/default.aspx">RE</category></item><item><title>Google's Chrome Comic Book Documentation</title><link>http://forums.blackbaud.com/blogs/documentation/archive/2008/09/09/google-s-chrome-comic-book-documentation.aspx</link><pubDate>Tue, 09 Sep 2008 18:56:00 GMT</pubDate><guid isPermaLink="false">f90a95a0-00e2-4810-8af8-0bbdde08f853:34042</guid><dc:creator>Lindsey Robbins</dc:creator><slash:comments>0</slash:comments><wfw:commentRss xmlns:wfw="http://wellformedweb.org/CommentAPI/">http://forums.blackbaud.com/blogs/documentation/rsscomments.aspx?PostID=34042</wfw:commentRss><comments>http://forums.blackbaud.com/blogs/documentation/archive/2008/09/09/google-s-chrome-comic-book-documentation.aspx#comments</comments><description>&lt;p&gt;The buzz in the online world the past few weeks is about Google&amp;#39;s new Internet browser &lt;a href="http://www.google.com/chrome" target="_blank"&gt;&lt;b&gt;Chrome&lt;/b&gt;&lt;/a&gt;. In the Technical Communication world, the buzz is around Google&amp;#39;s choice to create a &lt;a href="http://www.google.com/googlebooks/chrome/index.html" target="_blank"&gt;help &lt;/a&gt;&lt;a href="http://www.google.com/googlebooks/chrome/index.html" target="_blank"&gt;book&lt;/a&gt; to explain Chrome. Why the buzz? Well it was done in comic format. I&amp;#39;m not exactly sure why the rest of the Technical Communication world is up in arms. I thought it was a fun play on documentation and not meant to be the complete resource on *how to* use chrome. To understand this momentous project causing all the rage, I naturally turned to our own Blackbaud Technical Writer, Steve Stegelin. Most of you may not know it, but Steve started his career as a cartoonist and technical illustrator. In the meantime he&amp;#39;s done some pretty impressive work (on non-Blackbaud hours). Lately, you can find him several places. &lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;img src="http://www.charlestoncitypaper.com/binary/97c4/stegelin.jpg" align="right" width="400" height="363" alt="" /&gt;&lt;a href="http://www.charlestoncitypaper.com/" target="_blank"&gt;Charleston City Paper&lt;/a&gt; - &lt;a href="http://www.charlestoncitypaper.com/gyrobase/Archive?category=oid%3A6321" target="_blank"&gt;Weekly Cartoon&lt;/a&gt;, &lt;a href="http://www.charlestoncitypaper.com/gyrobase/Section?oid=oid%3A6364&amp;amp;category=oid%3A6328c" target="_blank"&gt;Blotter&lt;/a&gt;, Special Covers&lt;br /&gt;&lt;br /&gt;&lt;/li&gt;&lt;li&gt;&lt;a href="http://www.statehousereport.com" target="_blank"&gt;SC Statehouse Report&lt;/a&gt; - &lt;a href="http://www.statehousereport.com/newissue.htm#stegelin" target="_blank"&gt;Weekly Cartoon&lt;br /&gt;&lt;br /&gt;&lt;/a&gt;&lt;/li&gt;&lt;li&gt;Illustrated a Book - &lt;a href="http://search.barnesandnoble.com/Ill-Be-Sober-in-the-Morning/Chris-Lamb/e/9780972382946/?itm=1" target="_blank"&gt;&lt;i&gt;I&amp;#39;ll Be Sober in the Morning: Great Political Comebacks, Putdowns, &amp;amp; Ripostes&lt;br /&gt;&lt;br /&gt;&lt;/i&gt;&lt;/a&gt;&lt;/li&gt;&lt;li&gt;And he even generously donates his time to some in-house projects including designing t-shirts, adding illustrative touches to our quarterly company newsletter, and the occasional greeting card.&lt;br /&gt;&lt;/li&gt;&lt;/ul&gt;&lt;p&gt;In our cube this morning (yup, I&amp;#39;m the &lt;i&gt;fortunate&lt;/i&gt; one who sits with Steve every day), I asked him a few questions about this Google Chrome thing. I wanted to get to the bottom of the hoopla.&lt;br /&gt;&lt;br /&gt;&lt;b&gt;Lindsey :&lt;br /&gt;Why is this Google Chrome comic such a big deal?&lt;/b&gt;&lt;/p&gt;&lt;p&gt;&lt;b&gt;Steve:&lt;/b&gt;&lt;br /&gt;While it&amp;#39;s obviously a good bit of marketing gimmickry to promote Chrome, I think it&amp;#39;s a great method to explain just what makes it so different from the other browsers out there. Having Scott McCloud use caricatures of the various developers and designers to pass along the message also really helps give it a personal voice, which is a bit of genius, making it less about the corporate Google than about the team of individuals working to make Chrome succeed. With the open source-ness of Chrome, communicating in this way really helps promote its &amp;quot;by the people for the people&amp;quot; message. And as a fan of the comic medium, it&amp;#39;s actually quite validating to see the format promoted as such a &amp;quot;legitimate&amp;quot; form of communication by a corporation such as Google.&lt;br /&gt;&lt;b&gt;&lt;br /&gt;Lindsey:&lt;br /&gt;Who&amp;#39;s Scott McCloud and why should we know him?&lt;/b&gt;&lt;/p&gt;&lt;p&gt;&lt;b&gt;Steve:&lt;/b&gt;&lt;br /&gt;When I first started reading comics, Scott was the creator of the fun indie comic &amp;quot;Zot!&amp;quot; He&amp;#39;s since gone on to become the closest thing comics has to a &amp;quot;resident scholar&amp;quot; on the sequential art form. You may&amp;#39;ve seen his theses as graphic novels: &amp;quot;Understanding Comics&amp;quot;, &amp;quot;Reinventing Comics&amp;quot;, and &amp;quot;Making Comics.&amp;quot; Each is an entertaining and informative analysis of the comics medium, from the role of the reader, artist, and historian/forecaster. In particular, I think &amp;quot;Understanding Comics&amp;quot; is an invaluable read, not just for comics but for any type of communication of sequence to an audience… I find myself applying some of the thought discussed in that book to my own procedural writing in our user guides, to great effect.&lt;br /&gt;&lt;br /&gt;&lt;b&gt;Lindsey:&lt;br /&gt;Are you ready to do the entire Raiser&amp;#39;s Edge documentation set in comic form? ;-)&lt;/b&gt;&lt;/p&gt;&lt;p&gt;&lt;b&gt;Steve:&lt;/b&gt;&lt;br /&gt;LOL.&amp;nbsp; That might take a while…&lt;/p&gt;&lt;p&gt;&amp;nbsp;&lt;/p&gt;&lt;p&gt;Here&amp;#39;s a sample of the book: &lt;br /&gt;&lt;/p&gt;&lt;p&gt;&lt;img src="http://www.google.com/googlebooks/chrome/images/small/17.jpg" alt="" /&gt;&amp;nbsp;&lt;/p&gt;&lt;img src="http://forums.blackbaud.com/aggbug.aspx?PostID=34042" width="1" height="1"&gt;</description><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/technical+communication/default.aspx">technical communication</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Documentation/default.aspx">Documentation</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/humor/default.aspx">humor</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/visual+communication/default.aspx">visual communication</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Google/default.aspx">Google</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Comics/default.aspx">Comics</category><category domain="http://forums.blackbaud.com/blogs/documentation/archive/tags/Chrome/default.aspx">Chrome</category></item></channel></rss>