Technical Writing

  • Most Topular Stories

  • API explorers – play with a REST API the easy way

    ffeathers
    Sarah Maddox
    24 Jan 2015 | 6:07 pm
    To communicate with a REST API (or other web service API), you need to construct a request, send it over HTTP or HTTPS, then receive and parse the response. When creating an app, you do all that with code. But what if you just want to take a look around the API to see what it offers, before diving into the code? API explorers are your friend. I’ve been putting together some information for a workshop on API technical writing. It’s been a rewarding exercise, because it’s made me think in a structured, educational way about what I do every day. A section of the workshop deals…
  • API Archaeology: Complexity and sizing of an interface

    Just Write Click
    annegentle
    12 Jan 2015 | 6:06 pm
    For both OpenStack and Rackspace cloud APIs, we use WADL, Web Application Description Language, to build an API reference listing for all REST API calls. In a previous post I discuss how the reference pages at http://developer.openstack.org/api-ref.html are made with WADL source and a Maven plugin, clouddocs-maven-plugin. You can see the output for the Rackspace API reference page at http://api.rackspace.com, built with the same tool chain but different branding through CSS. I can discuss the tooling decision process in another post, but let’s talk about ongoing upkeep and…
  • Hot New 3-Hour Mini Course: Building a Strong LinkedIn Profile

    I Came, I Saw, I Learned...
    IconLogic
    23 Jan 2015 | 9:13 am
    Live, online, and 100% interactive! 3-hours of content... and just $79! Whether you are in the market for a new job, just starting your career, or are a well-established professional, LinkedIn is one of the most important tools for establishing your online presence. Good practices from the start help you to “brand” yourself & determine what kind of message you want to offer about yourself to the world. During this class, you will learn to use the most powerful features of LinkedIn to get your profile noticed. You will discover best practices for creating an online presence, learn…
  • Implementing ScrollSpy with Jekyll to auto-build a table of contents

    I'd Rather Be Writing
    Tom Johnson
    20 Jan 2015 | 12:41 pm
    I mentioned in a post last week that I’m experimenting with a Jekyll prototype for technical documentation. I stumbled upon one of the coolest and most interesting topics a few days ago while integrating “ScrollSpy” on Jekyll. ScrollSpy is a dynamic feature that “spys” on the headings as you scroll past them and dynamically highlights Continue Reading »
  • XML overview for executives

    Scriptorium Publishing
    Sarah O'Keefe
    20 Jan 2015 | 8:13 am
    Over the past year or two, our typical XML customer has changed. Until recently, most XML publishing efforts were driven by marketing communications, technical publications, or IT, usually by a technical expert. But today’s customer is much more likely to … Continue reading → The post XML overview for executives appeared first on Scriptorium Publishing.
  • add this feed to my.Alltop

    ffeathers

  • API explorers – play with a REST API the easy way

    Sarah Maddox
    24 Jan 2015 | 6:07 pm
    To communicate with a REST API (or other web service API), you need to construct a request, send it over HTTP or HTTPS, then receive and parse the response. When creating an app, you do all that with code. But what if you just want to take a look around the API to see what it offers, before diving into the code? API explorers are your friend. I’ve been putting together some information for a workshop on API technical writing. It’s been a rewarding exercise, because it’s made me think in a structured, educational way about what I do every day. A section of the workshop deals…
  • Educational programs and courses now in Tech Comm on a Map

    Sarah Maddox
    2 Jan 2015 | 9:14 am
    Tech Comm on a Map now has a category for educational programs and courses, such as university technical communication degrees or certificates and other training courses. Take a look and let me know if you have something to add. Tech Comm on a Map puts technical communication titbits onto an interactive map, together with the data and functionality provided by Google Maps. It’s a great way of seeing what we tech writers are up to, around the world. To find out more about the project, or to add something to the map, check out the project information page.
  • Webinar series on API tech writing, starting February 2015

    Sarah Maddox
    26 Dec 2014 | 11:08 am
    The STC (Society for Technical Communication) is presenting a series of webinars (online seminars) on API technical writing, starting in February. I’m delighted to be presenting the first webinar in the series: Part 1: Introduction to API Technical Writing. The role of API technical writer is exciting, rewarding, and challenging. In this webinar we’ll explore what an API is and does, see a couple of APIs in action (provided the demo gremlins stay away!), take a look at some examples of API documentation, and hear some tips on getting started in the role. Details of the first…
  • Workshop on API technical writing

    Sarah Maddox
    2 Dec 2014 | 12:57 pm
    I’m excited and delighted to announce that I’ll be presenting a one-day workshop on API technical writing, in conjunction with the Silicon Valley Chapter of the STC (Society for Technical Communication).  The workshop will be a practical course on API technical writing, consisting of lectures interspersed with hands-on sessions where you’ll apply what you’ve learned. The focus will be on APIs themselves as well as on documentation, since technical writers need to be able to understand and use a product before we can document it. Date: Friday, January 23rd, 2015…
  • Tech comm 2015 now on the map

    Sarah Maddox
    21 Nov 2014 | 11:39 am
    Tech Comm on a Map now displays all the 2015 technical communication conferences that I’ve found so far. Take a look, and let me know if there are any more tech comm conferences, groups, businesses or societies to add. Tech Comm on a Map puts technical communication titbits onto an interactive map, together with the data and functionality provided by Google Maps. It’s a great way of seeing what we tech writers are up to, around the world. To find out more about the project, or to add something to the map, check out the project information page.
 
  • add this feed to my.Alltop

    Just Write Click

  • API Archaeology: Complexity and sizing of an interface

    annegentle
    12 Jan 2015 | 6:06 pm
    For both OpenStack and Rackspace cloud APIs, we use WADL, Web Application Description Language, to build an API reference listing for all REST API calls. In a previous post I discuss how the reference pages at http://developer.openstack.org/api-ref.html are made with WADL source and a Maven plugin, clouddocs-maven-plugin. You can see the output for the Rackspace API reference page at http://api.rackspace.com, built with the same tool chain but different branding through CSS. I can discuss the tooling decision process in another post, but let’s talk about ongoing upkeep and…
  • How to get started writing API docs

    annegentle
    30 Dec 2014 | 11:17 am
    I know a lot of people who want to consume awesome API docs. Let’s talk about what it takes to get started writing them. I’m not talking about completing your API docs. I’m talking about just getting started, what does it take? For API documentation especially REST APIs, I’d advocate a reference-first approach. Like the couch to 5K program for running, let’s start API documentation on your couch. You look under your coffee table and find your shoes. You pull them on (make sure you have wrinkle-free socks!) and lace them up. You’re ready!   Please write…
  • Hackathons of Late

    annegentle
    22 Dec 2014 | 5:09 pm
    I’ve participated in a few hackathons in the past year, since I’ve been working on a team of developer advocates at Rackspace. I wanted to chronicle some of my experiences with a few goals in mind: recording memories for myself, letting others get ideas for the wide range of hackathons, and chronicling the wide variety of types of hackathons and outcomes of hackathons. For a bit of context, I’m female, have a family and weekend obligations that include sports practices, and I’m a generation-Xer if that gives you a sense of my age (with a range). I’ve definitely…
  • More posts around the web

    annegentle
    25 Aug 2014 | 8:14 pm
    Seems like more and more I’m writing everywhere but here! I wanted to do a round-up of some of my writing around the web. On the Rackspace Developer Blog: Austin Ladies Hackathon This weekend was a blast, hacking with all women at Rackspace, and wow were the projects impressive. Here’s how it went. Friday night we gathered at a restaurant, the Flying Saucer, to meet each other and start to form teams. I’d guessimate that 20 of the 30 participants showed up. I helped out by facilitating discussions for people to find teams, and I spent a lot of the night talking to complete…
  • All About that OpenStack Operations Guide

    annegentle
    1 May 2014 | 2:16 pm
    I wrote a post on the O’Reilly Programming blog about our experiences writing a book in five days and revising it for publication as an O’Reilly book. The blog post is titled, The book sprint: Not just for code any more. This infographic summarizes the numbers quite well. Many thanks to Racker Claudia Charbel for this infographic and for showing off the capabilities of Canva.com!
  • add this feed to my.Alltop

    I Came, I Saw, I Learned...

  • Hot New 3-Hour Mini Course: Building a Strong LinkedIn Profile

    IconLogic
    23 Jan 2015 | 9:13 am
    Live, online, and 100% interactive! 3-hours of content... and just $79! Whether you are in the market for a new job, just starting your career, or are a well-established professional, LinkedIn is one of the most important tools for establishing your online presence. Good practices from the start help you to “brand” yourself & determine what kind of message you want to offer about yourself to the world. During this class, you will learn to use the most powerful features of LinkedIn to get your profile noticed. You will discover best practices for creating an online presence, learn…
  • Localization: Training and Development in Panama

    IconLogic
    23 Jan 2015 | 9:04 am
    by Jen Weaver     This week let's explore some common cultural facts about Panamanians and their expectations when it comes to Training and Development.Test Your Knowledge of Panamanian Culture Is Panama part of Central America or Northern America? True or False? Panama has the same governmental structure as the United States, which includes a president and a vice president. Quick Tips for Training & Development in Panama1: Public criticism is frowned upon, as Panamanians work diligently to maintain an image of harmony. Be careful not to criticize students or team…
  • Adobe Captivate: Use Smart Shapes Instead of Text Captions

    IconLogic
    22 Jan 2015 | 7:34 am
    by Kevin Siegel      I've written about Captivate's Smart Shapes a few times since Adobe first introduced them. If you want to know what they are, check out this article. If you want to learn how to use Smart Shapes as buttons, I've got you covered. This time I'm going to cover how you can use Smart Shapes instead of Text Captions in just about every development scenario.  Since Smart Shapes are far more flexible (when it comes to formatting) than standard buttons or text captions, I'd love to see Adobe completely replace text…
  • Writing & Grammar: Meeting of Peeved Minds

    IconLogic
    20 Jan 2015 | 7:52 am
    by Jennie Ruby    We are finding some agreement, those of us sharing our pet peeves. First, Lisa J. Stumpf voices her agreement with Michael Stein: I totally agree with Michael. Moot is much different in meaning and sound than mute! And keep the "t" sound out of often! And on the topic of pronunciation (have you heard people say "pro-nounce-ee-a-shun"?), Julie Walawender gives us "processes": One of my pet peeves is the mispronunciation of the plural form of process. The correct pronunciation is pros-es-iz,…
  • Adobe FrameMaker: GREP to Replace Hyphens with En Dashes

    IconLogic
    15 Jan 2015 | 8:53 am
    by Barb Binder   Adobe FrameMaker 12  supports GREP Find/Change (General Regular Expression Print), but I tend to forget about it because it's not prominently featured in the Find/Change dialog box.One of my major headaches in a FrameMaker layout job is updating hyphens to en dashes between ranges of numbers, as outlined in my article on GREP in Adobe InDesign. Without the aid of GREP, I run 10 replacements, 1- to 1-. 2- to 2-, etc. It's tedious, but if I wait until I have all the files in the book, I can do it once and be done with it.Until today. Thanks to a…
 
  • add this feed to my.Alltop

    I'd Rather Be Writing

  • Implementing ScrollSpy with Jekyll to auto-build a table of contents

    Tom Johnson
    20 Jan 2015 | 12:41 pm
    I mentioned in a post last week that I’m experimenting with a Jekyll prototype for technical documentation. I stumbled upon one of the coolest and most interesting topics a few days ago while integrating “ScrollSpy” on Jekyll. ScrollSpy is a dynamic feature that “spys” on the headings as you scroll past them and dynamically highlights Continue Reading »
  • Moving from passive to reactive documentation — recording of presentation by Greg Koberger, ReadMe.io founder

    Tom Johnson
    19 Jan 2015 | 7:51 am
    The following is a recording of a presentation about passive versus reactive documentation by Greg Koberger, developer and designer for ReadMe.io, a slick new REST API documentation tool. Greg gave this presentation at the STC Silicon Valley chapter meeting on January 12, 2015 in Santa Clara, California. (He gave a similar presentation to a Write Continue Reading »
  • Most important factor in APIs is complete and accurate documentation

    Tom Johnson
    15 Jan 2015 | 7:20 am
    A 2013 survey by Programmable Web that included about 250 respondents found that complete and accurate documentation was the most important factor in an API: This is certainly an encouraging finding for technical writers, and suggests that more attention and focus should be given to documentation. I think I’m going to print this picture out Continue Reading »
  • API doc survey: Do engineers write API doc in the source code?

    Tom Johnson
    15 Jan 2015 | 7:08 am
    Another question in my API doc survey was as follows: Do engineers write the initial API documentation in the source code (e.g., Javadoc syntax)? 42 people responded. The results are as follows: This question was a little problematic. Because a lot of tech writers are working on REST APIs, a lot of developers don’t write reference Continue Reading »
  • API doc survey: How much of your doc process is automated?

    Tom Johnson
    15 Jan 2015 | 6:02 am
    This question in my API doc survey was so poorly worded that the answers are mostly confusing. Unfortunately, this was the first question in the survey and probably the most vague. Here’s the question: Do you generate Javadoc or Doxygen files manually, or are they auto-rendered as part of the build process? REST API documentation Continue Reading »
  • add this feed to my.Alltop

    Scriptorium Publishing

  • XML overview for executives

    Sarah O'Keefe
    20 Jan 2015 | 8:13 am
    Over the past year or two, our typical XML customer has changed. Until recently, most XML publishing efforts were driven by marketing communications, technical publications, or IT, usually by a technical expert. But today’s customer is much more likely to … Continue reading → The post XML overview for executives appeared first on Scriptorium Publishing.
  • 2015 content trends

    Alan Pringle
    12 Jan 2015 | 6:20 am
    It’s a new year, which means it’s time for Scriptorium to discuss—and wildly speculate about—the latest trends in content. Here’s what Bill Swallow, Gretyl Kinsey, and I had to say about 2015 content trends. Content strategy driven by IT Alan: … Continue reading → The post 2015 content trends appeared first on Scriptorium Publishing.
  • Beneath the page: learning to see structure

    Sarah O'Keefe
    6 Jan 2015 | 5:30 am
    We hear a lot about the learning curve for structured authoring, but what does that really mean? Experienced knitters learn to read the work—they can look at a knitted object and map the knitted version to a written or charted … Continue reading → The post Beneath the page: learning to see structure appeared first on Scriptorium Publishing.
  • Content strategy and DITA and localization, oh my! Our best of 2014

    Alan Pringle
    29 Dec 2014 | 6:15 am
    Yes, you need another “best of 2014″ list to round out the year. Without further ado, here are Scriptorium’s top 2014 blog posts on content strategy, DITA, and localization. A hierachy of content needs Maslow has his hierarchy of human … Continue reading → The post Content strategy and DITA and localization, oh my! Our best of 2014 appeared first on Scriptorium Publishing.
  • Celebrating the good stuff (Blog Secret Santa)

    Sarah O'Keefe
    24 Dec 2014 | 6:54 pm
    Or: A stranger takes over the Scriptorium blog and gets all enthusiastic about tone of voice Merry Christmas, Scriptorium readers. And, Sarah O’Keefe, an especially Merry Christmas to you. I’m your writer, Santa, and this is your Blog Secret Santa … Continue reading → The post Celebrating the good stuff (Blog Secret Santa) appeared first on Scriptorium Publishing.
 
  • add this feed to my.Alltop

    CyberText Newsletter

  • Stop Brother laser printer ‘Replace Toner’ message

    Rhonda
    22 Jan 2015 | 1:30 pm
    Printer companies want you to buy their toner, and they want you to replace that toner long before it runs out. They do this by various means; typically beeps, popup screens, warning messages on the display panel of the printer etc. How they gauge when the toner needs replacing varies by manufacturer too — some alert you based on number of pages printed (assuming that you are printing an entire page of solid toner every time), others use a laser beam through a hole in the printer cartridge (true! — see this video: https://www.youtube.com/watch?v=PK9qUeH1AVU), and still others by…
  • Installing Microsoft Office

    Rhonda
    6 Jan 2015 | 1:30 pm
    Prior to Christmas I decided to upgrade my old clunker of a laptop from Vista to Windows 7. I’d put it off for more than a year as my experience with previous upgrades hasn’t been pleasant. Surprisingly, it all went very well. Yes, it took some time but Microsoft’s friendly upgrade/installation screens warned me about that. In fact, the whole experience was a good one. However, I also decided to upgrade from Office 2007 to Office 2013. That failed. So I decided to install Office 2010 instead. That also failed after several hours and attempts. Then I tried to uninstall all…
  • Children suck

    Rhonda
    5 Jan 2015 | 1:30 pm
    Or at least, that’s what this sign says. Spotted in my local medical surgery near the children’s play area. I think they meant to tell parents to put any toys into the bin that their children have put into their mouths or that they have dirtied. It might have been better to avoid ‘dirty’ and ‘suck’ (especially the unfortunately worded ‘children suck’) and instead used wording similar to this: ‘For used play area toys. Please put play area toys used by your children into this bin.’Filed under: Grammar & Punctuation, Humor
  • Very helpful, Australia Post… NOT!

    Rhonda
    4 Jan 2015 | 1:30 pm
    A few weeks ago, I received an email about a parcel that had been sent. The email included an Australia Post tracking number, with a link to Australia Post’s tracking website. I clicked the link and got this message: ‘Product not trackable’. Nothing else. So I went to Australia Post’s support section on their website and typed in those words, expecting to get an article about why some parcels are not trackable even if they have a tracking number. But I got this instead: Not one of those answers addressed the question. And the first and third answers didn’t relate…
  • 2014 blog statistics

    Rhonda
    1 Jan 2015 | 12:52 am
    In March 2014, this blog broke through the four million views mark since I started blogging in 2008. And around August 2014, it broke through five million views — and I didn’t even notice until now! By 31 December 2014, it had had more than 5.4 million views. Some 1.58 million views (more than one-third) occurred just in 2014. These figures don’t include any visits I made to my own blog (yes, I use my own blog for stuff I can’t remember!). I wrote far fewer blog posts in 2014, so many of these visits were to posts I’ve written in previous years. I’ve…
  • add this feed to my.Alltop

    Communications from DMN

  • Three resources for outsourcing your tasks

    Scott Nesbitt
    22 Jan 2015 | 5:52 am
    (Note: This post was originally published here and appears in this space via a Creative Commons license) Time. Few of us have a lot of it. Especially busy freelance technical writers. There are always little (or not-so-little) tasks that we don’t always have the time to tackle. Or, maybe, we don’t have the skills to tackle those tasks quickly and efficiently. Sometimes, you just have to bite the bullet and pay someone to do that work for you. Over the last couple of years, I’ve been doing that every so often. The (small) sums I’ve spent have been worth it. They’ve freed up a little…
  • Four open source invoicing tools for freelancers and small businesses

    Scott Nesbitt
    13 Jan 2015 | 6:11 am
    (Note: This post was originally published on September 2, 2014 at Opensource.com and appears here via a Creative Commons license) Small business owners and freelancers put a lot of work into their businesses. They do that not only because they’re passionate about what they do, but because they also have the goal of getting paid. That’s no small part of the job, either. Getting paid usually means sending a client an invoice. It’s easy enough to whip up an invoice using a word processor or a spreadsheet, but sometimes you need a bit more. A more professional look. A way of keeping track…
  • Tips for rapid writing

    Scott Nesbitt
    6 Jan 2015 | 6:43 am
    (Note: This post was originally published, in a slightly different form, here.) There comes a time in the career of every writer (technical or otherwise) when you’re looking at the wrong end of a looming deadline and don’t have anything close to being ready to send out. Or you might be asked to write something before the end of the day or in next couple of hours. What do you do when that happens? Some writers will panic. Others will be frozen with fear. Others will scramble to get something, anything written. Regardless of the quality. There’s no need to do any of that. Unless what…
  • Creating a rate card

    Scott Nesbitt
    16 Dec 2014 | 6:39 am
    (Note: This post was originally published, in a slightly different form, here) If you’re a freelance technical writer, chances are you 1) have prospective clients asking you how much you charge, and 2) do more than just write user documentation. You might also, for example, do copywriting, API documentation, editing and proofreading, content consulting, and more. You might have committed your rates to memory, but if you offer more than a couple of services that might not be a good idea. Many potential clients (and returning ones) want something tangible (or, at least, digital), to which…
  • 3 books that can help you tame Evernote

    Scott Nesbitt
    4 Nov 2014 | 5:30 am
    Note: This post was originally published here. Evernote is a useful and flexible tool for anyone, especially writers– technical or otherwise. You can use Evernote to record your research, outline your writing, hammer out drafts, collect links and citations, manage your tasks, and more. It can be a bit challenging to get up and running with Evernote. And, if you’re like me, you sometimes overthink things and that makes the process of working with a tool like Evernote a bit more difficult. A good guide, in the form of a good book, can help. For the longest time, there was a dearth…
 
  • add this feed to my.Alltop

    Core Dump 2.0

  • My phone is now a slide rule

    Keith
    25 Jan 2015 | 7:13 am
    Earlier this week I was thinking about all the different things my Samsung smart phone could do. Not counting pure Internet applications like IMDB or Cineplex, I came up with about thirty. Now I can add another one to the list – my phone is now a slide rule. A slide rule? What’s that, some of my younger readers may be asking. Wikipedia has a good, detailed explanation: The slide rule, also known colloquially in the United States as a slipstick,[1] is a mechanical analog computer.[2][3][4][5][6] The slide rule is used primarily for multiplication and division, and also for…
  • Moving ebooks between devices

    Keith
    23 Jan 2015 | 1:05 am
    If you own an ereader or tablet, you may decide that you want to upgrade or change your system – perhaps to move from a Nook to a Kobo or a Kobo to an Apple tablet. Even though these devices all nominally use EPUB as the base format, the DRM (Digital Rights Management) software they use to prevent piracy makes this task difficult, and potentially impossible. This ABC news article explores some of the options. Amazon.com Inc. distributes its e-books in a proprietary format that isn’t compatible with other devices and systems. Other companies have embraced a format called EPub. In…
  • What if Ebola becomes endemic?

    Keith
    22 Jan 2015 | 1:43 am
    Efforts to stamp out the Ebola outbreak in Africa have been remarkably successful. Despite the fact that almost 10,000 people have died, it could have been much, much worse. But it’s now almost a year since the outbreak started and it’s not contained by any means. What happens if Ebola can’t be completely eradicated, and keeps flaring up in different places, or worse, spreads to other, more populated countries?  Discover looks at this disquieting scenario. The implications of an endemic Ebola are equally muddled. Epidemic risk management consultants Jody Lanard and Peter…
  • Google invests in SpaceX

    Keith
    21 Jan 2015 | 4:39 pm
    Google has made a major investment – $1 billion dollars – in SpaceX. They’ll get a 10 percent ownership stake in the company. Google apparently wants to put up a network of satellites that could bring Internet services to almost anywhere in the world. They may also be planning to launch Earth observation satellites to improve the quality of the imagery in Google Earth. I like this news – a lot. Google likes its ambitions sky high. This time, it has gone a little further.The Internet giant, along with Fidelity, has invested $1 billion in Space Exploration Technologies…
  • The future of house building

    Keith
    20 Jan 2015 | 1:53 am
    A company in China has used 3D printing technology to build a mansion and a 6-storey apartment building. The mansion wouldn’t look out of place in an upscale Toronto neighbourhood. The article doesn’t go into a lot of detail on how they handle things like plumbing and wiring, but the 3D printing technique certainly seems capable of handling the structural elements. The second trick up their sleeve is the printer used to build the houses, which is 6.6 meters tall 10 meters wide, and 150 meters long. “This is the world’s first continuous printing 3D printer, and the…
  • add this feed to my.Alltop

    EServer TC Library: Recent Additions

  • From Empathy to Advocacy

    6 Jan 2015 | 8:35 pm
    For the past several years, I’ve been privileged to work with a number of local advocacy organizations in my community. Doing so has made me keenly aware of the crucial role that advocates play. They operate on scales both large and small—from working with lawmakers to shape public policy, to helping a single parent fill out the paperwork to find child care that enables them to keep a job. Mullican, Lyle
  • The Core Model: Designing Inside Out for Better Results

    6 Jan 2015 | 8:34 pm
    If you’ve worked on a website design with a large team or client, chances are good you’ve spent some time debating (arguing?) with each other about what the homepage should look like, or which department gets to be in the top-level navigation—perhaps forgetting that many of the site’s visitors might never even see the homepage if they land there via search. Aalen, Ida
  • A Typology for Data Visualization on the Web

    6 Jan 2015 | 8:15 pm
    The need to visualize data has emerged from the research field, it has been a useful tool to the study of scientific problems. However the truth is that data visualization is a great way to present data for any area dealing with information, because visually presented information is not only more appealing due to its use of pictograms and colours, but also more efficient in conveying large amounts of information. Throughout the years there have been efforts to develop a classification for these visualizations, in order to provide a better understanding of this way to present data. There are…
  • Designing Great Organizational Services

    5 Jan 2015 | 5:13 am
    I began my career over twelve years ago in marketing, defining the user experiences for healthcare Web sites at an interactive agency. At first, I loved the dynamic environment and start-up feel of an agency. It felt great that a large audience would interact with the sites that I helped design. Over time, however, I realized that I wasn’t doing good UX design. Rather, I was doing whatever the agency Account Manager or client Brand Manager wanted, which didn’t always jibe with what customers needed. Keller, Laura
  • Making User Experience Part of Business Strategy | Understanding a Product’s Target Culture

    5 Jan 2015 | 5:13 am
    In this edition of Ask UXmatters, our panel of UX experts discusses two topics: how to integrate user experience into an organization’s product and business strategy, and how to best understand the culture of an organization for which you are providing design solutions. Six, Janet M.
  • add this feed to my.Alltop

    I Came, I Saw, I Learned...

  • Hot New 3-Hour Mini Course: Building a Strong LinkedIn Profile

    IconLogic
    23 Jan 2015 | 9:13 am
    Live, online, and 100% interactive! 3-hours of content... and just $79! Whether you are in the market for a new job, just starting your career, or are a well-established professional, LinkedIn is one of the most important tools for establishing your online presence. Good practices from the start help you to “brand” yourself & determine what kind of message you want to offer about yourself to the world. During this class, you will learn to use the most powerful features of LinkedIn to get your profile noticed. You will discover best practices for creating an online presence, learn…
  • Localization: Training and Development in Panama

    IconLogic
    23 Jan 2015 | 9:04 am
    by Jen Weaver     This week let's explore some common cultural facts about Panamanians and their expectations when it comes to Training and Development.Test Your Knowledge of Panamanian Culture Is Panama part of Central America or Northern America? True or False? Panama has the same governmental structure as the United States, which includes a president and a vice president. Quick Tips for Training & Development in Panama1: Public criticism is frowned upon, as Panamanians work diligently to maintain an image of harmony. Be careful not to criticize students or team members in…
  • Adobe Captivate: Use Smart Shapes Instead of Text Captions

    IconLogic
    22 Jan 2015 | 7:34 am
    by Kevin Siegel      I've written about Captivate's Smart Shapes a few times since Adobe first introduced them. If you want to know what they are, check out this article. If you want to learn how to use Smart Shapes as buttons, I've got you covered. This time I'm going to cover how you can use Smart Shapes instead of Text Captions in just about every development scenario.  Since Smart Shapes are far more flexible (when it comes to formatting) than standard buttons or text captions, I'd love to see Adobe completely replace text captions and buttons with Smart…
  • Writing & Grammar: Meeting of Peeved Minds

    IconLogic
    20 Jan 2015 | 7:52 am
    by Jennie Ruby    We are finding some agreement, those of us sharing our pet peeves. First, Lisa J. Stumpf voices her agreement with Michael Stein: I totally agree with Michael. Moot is much different in meaning and sound than mute! And keep the "t" sound out of often! And on the topic of pronunciation (have you heard people say "pro-nounce-ee-a-shun"?), Julie Walawender gives us "processes": One of my pet peeves is the mispronunciation of the plural form of process. The correct pronunciation is pros-es-iz, NOT pros-es-eez. An online resource suggests…
  • Adobe FrameMaker: GREP to Replace Hyphens with En Dashes

    IconLogic
    15 Jan 2015 | 8:53 am
    by Barb Binder   Adobe FrameMaker 12  supports GREP Find/Change (General Regular Expression Print), but I tend to forget about it because it's not prominently featured in the Find/Change dialog box.One of my major headaches in a FrameMaker layout job is updating hyphens to en dashes between ranges of numbers, as outlined in my article on GREP in Adobe InDesign. Without the aid of GREP, I run 10 replacements, 1- to 1-. 2- to 2-, etc. It's tedious, but if I wait until I have all the files in the book, I can do it once and be done with it.Until today. Thanks to a series of…
 
  • add this feed to my.Alltop

    Technical Writing ToolBox

  • Webinar – Higher Education in Technical Communication

    Gurpreet Singh
    20 Jan 2015 | 11:14 am
    I am conducting a webinar titled “Higher Education in Technical Communication”  for STC India Management SIG. Please register if you are interested in learning more about higher education opportunities in technical writing. Registration link: http://www.stc-india.org/events/webinar-jan-31-2015-higher-education-in-technical-communication/ Filed under: Presentation, STC, Toronto Tagged: Education, Technical communication, Technical writing
  • Youtube Webinar Recording- API Documentation

    Gurpreet Singh
    13 Oct 2014 | 4:44 pm
    I recently conducted a webinar on API documentation for STC India Management SIG. You can view the Youtube video recording of the session on this blog post. I would love to hear your feedback regarding this session. Is it exciting? Is it boring? Would you like to attend my next webinar? Please leave a comment […]
  • Webinar on API Documentation for STC India Management SIG

    Gurpreet Singh
    25 Sep 2014 | 11:32 am
    I am conducting a webinar on API documentation for STC India Management SIG. Please register if you are interested in learning more API documentation. Registration link: http://www.stc-india.org/events/webinar-api-documentation/ Filed under: Elements of Technical Writing Tagged: Application Programming Interface, careercast, Communication, Management SIG, stc
  • Top 10 Best Jobs in 2013

    Gurpreet Singh
    14 Mar 2014 | 1:09 pm
    In my last blog post, I talked about the 60th best job in 2013- Technical Writing. But what about the top 10 best jobs in 2013? Comcast released a list of top 200 different jobs in the U.S based on five criteria: physical demands, work environment, income, stress and hiring outlook. The data for this report […]
  • Technical Writing: The 60th Best Job in 2013

    Gurpreet Singh
    12 Mar 2014 | 11:22 am
    Following the yearly tradition, Careercast released  a list of top 200 different jobs in the U.S based on five criteria: physical demands, work environment, income, stress and hiring outlook. The data for this report came from the Bureau of Labor Statistics and other government agencies in U.S. Technical Writer was the 60th best job in 2013 though it […]
  • add this feed to my.Alltop

    ApraDocs Information Developers

  • STC India Learning Event

    Rahul Karn
    7 Jan 2015 | 10:08 am
    LEARNING SESSION – DELHI (NCR)] 17TH JANUARY 2015: SPANISH AND INFOGRAPHICS SESSIONDate/TimeDate - 17/01/20159:45 am - 1:30 pmLocationDelhi (NCR) In this new year, Delhi (NCR) STC India group has planned some sessions on info graphics and basics of Spanish. Therefore, there will be one session on these two topics in next few Delhi (NCR) learning sessions with association of ApraDocs Information Developers.The info graphics sessions are aimed at helping technical communicators in making their technical documentation persuasive for the target audience by creating and using info graphics…
  • Happy New Year-2015

    Rahul Karn
    1 Jan 2015 | 12:46 am
    New Year AheadWe wish our reader a great year ahead.
  • Performance of Information Developers group-2014

    Rahul Karn
    31 Dec 2014 | 1:36 am
    2014- Year It WasApraDocs Information Developers is .in by registration but .org by heart.We impart technical writing training in India and online by charging minimal fee and deliver more than we commit.Apart from our regular students, we also offer lot of free learning through different platform like blog,LinkdIN page,LinkedIN goup,Facebook page and sponsoring technical writers conferences in Delhi area.Our growth is growth of all the technical writers directly or indirectly involved with us.We partnered with Multivertex for technology support.Started our new venture Digital marketing…
  • Test the Map IDs of a RoboHelp Context Sensitive HTML Help File

    Rahul Karn
    26 Dec 2014 | 2:17 am
    Map IDs in RoboHelp11If you have Map IDs and not able to test it. RoboHelp provide a wonderful tool to test it. What is Map IDs All context sensitive help files have each individual help topic assigned a Map ID number.The application developers integrate that ID into the application so that when a user presses the F1 button in a topic screen, the application reads the Map ID of the topic and displays the correct topic that corresponds to that Map ID number.Question: Before giving it to the developers how would you know if your Map IDs are…
  • Best fonts for technical writers

    Rahul Karn
    17 Dec 2014 | 11:13 pm
    So, as a Technnical writer, it just makes sense to make sure the font you or your clients use is one that doesn't hinder sales in any way.To help you, I did some research into the best fonts to use for print, online, and email. Let’s start with:The difference between 'serif' and 'sans serif' fontsSerif fonts have little feet and embellishments on the tip and base of each letter, making them more distinct and recognizable. Popular serif fonts are Times New Roman, Palatino, Georgia, Courier, Bookman and Garamond.Nearly all books, newspapers, and magazines use a serif font. It's popularly…
  • add this feed to my.Alltop

    Wylie Communications, Inc.

  • Keywords for killer subject lines

    Ann Wylie
    24 Jan 2015 | 9:00 pm
    Which words to use — and avoid — from Adestra’s analysisIs this the world’s best subject line: Alert: Free delivery, 50% off daily? And is this the world’s worst: Fw: Register for our Webinar and report? Probably not. But the words we use matter, and the words we use in subject lines matter a lot.Snore subject Which words tanked in Adestra’s subject line analysis? Webinar, Learn and Report, among others.Enter Adestra, a U.K.-based email service provider. It recently analyzed a random sample of more than 2 billion emails to learn which words work — and…
  • Extreme makeover

    Ann Wylie
    17 Jan 2015 | 9:00 pm
    Strathcona County embraces the feature-style story structureToo many communicators have married the inverted pyramid and made a lot of triangular babies. Problem is, the traditional news structure doesn’t work well with humans.But in Alberta, Ontario, communicators are starting to flirt with other structures. After attending one of my Beyond the Inverted Pyramid workshops, Elizabeth Tadman-Kickham, communications & marketing specialist at Strathcona County, rewrote a news story into a feature. Here’s the result:Strathcona County makes over a traditional news…
  • Every picture tells a story

    Ann Wylie
    10 Jan 2015 | 9:00 pm
    Multiply Twitter, PR engagement with an imageWhat simple element can you add to your tweet to increase retweets by more than one-third? An image, according to Twitter’s own research.Worth more than 140 characters This tweet by Toyota USA garnered 23,444 impressions and got retweeted 63 times and favorited 52.That’s a pretty big bang for a story element that takes up only 23 characters on Twitter.Plus, there’s more:Tweets with photos multiply engagement by 1,272%, according to an analysis from Simply Measured.Adding an image to a tweet can boost leads by 55%, according to a…
  • Serial monogamy

    Ann Wylie
    3 Jan 2015 | 9:00 pm
    Why have people fallen in love with this podcast?It’s been compared to The Sopranos. Before its debut, it ranked No. 1 on iTunes. When its first season was over, fans couldn’t remember what people do who aren’t listening to it.Give me more of that! Why do people love Serial? For the mystery and fine storytellingIt’s Serial, a true-crime procedural by the creators of This American Life. The podcast follows the story of Adnan Syed, who has been in prison for 15 years for the murder of his ex-girlfriend, Hae Min Lee.What can you steal from Serial?Why is Serial so popular?
  • All-time low

    Ann Wylie
    27 Dec 2014 | 9:00 pm
    Americans average 19 minutes a day readingThe average American reads for pleasure less than 20 minutes a day, according to a new study from the U.S. Bureau of Labor Statistics.At that rate, it would take most readers nearly a month to finish Divergent.Time is not on our side Depending on where they live, Americans spend 13 to 29 minutes a day reading.How people spend their timeDepending on where they live, Americans spend their time:Engaging in leisure activities: 4 hours, 27 minutes a day (Utah) to 6 hours, 8 minutes a day (West Virginia)Watching TV: 2 hours, 3 minutes a day (West Virginia)…
 
  • add this feed to my.Alltop

    Techpanorma.com

  • VideoSound iPhone App: Add Your Favorite Music (Tune) to Instagram and Facebook Videos/ Photos

    Happy Raj
    22 Jan 2015 | 11:06 pm
    Music has always been considered one of the best alternatives for fun and passing time. And when music is mixed and matched with your photos and videos, it refreshes all your memories and gives you priceless joy. VideoSound is developed by Bits and Coffee enables the user to spice up Facebook and Instagram videos by adding your favorite music to them. VideoSound allows the user to add music tracks to their videos and they can even add sound recording to the videos by making use of the in- app recorder. It also enables the user to create slideshows using pictures and music tracks. You can also…
  • How To Solve “This Webpage has a Redirect Loop” Error in Easy Steps

    Happy Raj
    2 Jan 2015 | 2:07 am
    Have you ever come across such error on your webpage “This Webpage has a redirect loop”? The web is full of such errors and many of us keep wondering how to solve such errors, but not to worry as internet also provides you a solution to such type of errors, all you need to do is to search properly. Today we are going to discuss the solution to this problem i.e., Error 310 (net::ERR_TOO_MANY_REDIRECTS). Recently I was browsing a website using Google Chrome and came across this error which was not allowing me to get access to this webpage. At that moment I felt very helpless and decided to…
  • Top Five Cool Notepad Tricks for PC – Tricks & Hack

    Happy Raj
    28 Dec 2014 | 12:35 am
    Hello guys we are back with yet another interesting topic for you, today we will discuss one of the famous text editors provided by Microsoft in all the versions of Windows, Yes we are talking about “Notepad” we all know how it works but most of us are restricted to use it just for writing notes, the files we save in Notepad are saved in .txt format which is compatible with almost every text editor and this is the reason it is been used by millions of Windows computer. However, Notepad is not limited to merely writing text but it has diverse hidden applications which surely most of us are…
  • How to Transfer Contacts from iPhone to iPhone

    Happy Raj
    26 Dec 2014 | 5:26 am
    This is one of the hardest things to do in an iPhone for the people who are using iPhone for the first time; I have seen many people who buy this elite gadget searching over the internet how to transfer contacts to new iphone or transferring contacts from one iphone to another iphone. In this post we are going to share with you some simple steps to transfer contacts from one iphone to another. So without any further delay let’s get straight to the point, follow the below mentioned steps to learn the mystery of transferring contacts from one iphone to another. [Using iCloud]: How to Transfer…
  • Best Apps for Teachers using iPads in the Classroom

    Happy Raj
    24 Dec 2014 | 4:43 am
    Ever since I was a kid I used to carry heaps of books and notebooks to school on my shoulder which always created a ruckus in my mind, teachers used to carry our books in their hand and teaching us in the class, we used to carry pencils, erasers and all other fancy new tools in our bag, I am sure all of us would be familiar with this scene. We always wanted to improve our education system with some innovating and captivating methods of using technology in the classroom, thank god in the age of technology we have improved system of education in the world, ever since iPads in education were…
  • add this feed to my.Alltop

    iTechnfun

  • Hello world!

    admin
    18 Jan 2015 | 10:40 am
    Welcome to WordPress. This is your first post. Edit or delete it, then start blogging! The post Hello world! appeared first on iTechnfun.
  • add this feed to my.Alltop

    Tech Ranger

  • Activate and Use WhatsApp Web from your PC and Android

    VR
    21 Jan 2015 | 10:10 pm
    It’s official, WhatsApp Web is finally available. Allows all users to chat with phones from computers or tablets. From now on, the instant messaging service will not only check on smartphones. Officially, he launched WhatsApp Web , allowing its 700 million users access to conversations, contacts and groups from any device with a browser. It takes a user Whatsapp on smartphones. The new functionality comes a day after WhatsApp blocked third party services like WhatsApp Plus , what could be a symptom of the need to further protect the privacy of users. While until now, through some…
  • Download WhatsApp For PC Windows 7/8/8.1 Whatsapp on PC Without Bluestacks

    Bharath Sirikonda
    11 Jan 2015 | 9:40 am
    WhatsApp Download for PC Windows without Bluestacks : Undoubtedly WhatsApp is one of the best online chatting messenger in the world and hence it was bought by the top social networking site Facebook for a such huge price, 19 Billion dollars. This has got enpugh craze among the users, especially among the youngsters who will be glued with this app for the most of the time, chatting with their close ones, loved ones who are both far and near to them. This app enables a user to chat by sending messages, can send images, videos(upto some limited mb) and also cansend the voice texts. This app is…
  • Gopala Gopala Movie Review Rating & Collections – Pawan Kalyan, Venkatesh

    Bharath Sirikonda
    9 Jan 2015 | 9:31 pm
    Director : Kishore Kumar Pardasany Producer : D.Suresh Babu and Sharat Marar Screenplay : Kishore Kumar Pardasany, Bhoopathy Raja and Deepak Raj Story : Umesh Shukla, Bhavesh Mandalia Star Cast : Daggubati Venkatesh, Pawan Kalyan, Shriya Saran, Mithun Chakraborty, Anju Asrani, Posani Krishna Murali, Krishnudu Music Director : Anoop Rubens Cinematography : Jayanan Vincent Editor : Gautham Raju Production Company : Suresh Productions and North Star Entertainments Pvt. Ltd. Distribution Company : BlueSky Cinemas Inc., Release Date : 10th January, 2015 Language : Telugu Budget : Rs.120 million…
  • *Download Tango for PC Windows 8/7/Xp/Laptops Free

    VR
    5 Jan 2015 | 3:30 pm
    Tango for PC is the PC version of the new Tango IM app available for almost all mobile devices running Android, Iphone and Windows Mobile operating systems. Tango for PC gives you the opportunity to settle this fantastic app on your pc or laptop. Tango for PC is, along with Whatsapp for PC and WeChat for PC , one of the instant messaging app’s most successful. Currently there are more than 100 million users worldwide who use Tango for PC to communicate with family and friends. However, it is different from other applications, including Viber for PC. It not only allows you to send…
  • WhatsApp soon to have voice calling, Screenshots Leaked

    Bharath Sirikonda
    4 Jan 2015 | 5:36 am
    WhatsApp is without a question the most used online messenger in the world with respect to mobiles and smart phones. It has took as a storm in the modern world with increasing users day by day. In spite of its huge popularity the executives of WhatsApp have said many a times that the features of WhatsApp is said to have rather rudimentary and limited. But the latest reports suggest that earlier this year voice calling feature in WhatsApp has started surfacing in the internet. Now an Android blog which is named as AndoridWorld.nl has leaked the screenshos of rumored calling feature in…
 
  • add this feed to my.Alltop

    Dissertation India

  • Break Down Analysis and Others

    Kalpesh
    22 Jan 2015 | 11:50 pm
    Breakdown and ANOVA: The creation and content of the middle level cells of the breakdown tree is dependent upon the way in which the independent variables are arranged to each other. The statistical tests that are used in breakdown are of exploratory analysis nature. This technique attempts to answer certain questions and they are very simple. Are the groups that have been created by the independent variable different regarding the dependent variable? If there is interest to find out the difference concerning the means, then the most suitable test would be one-way ANOVA. However, if there is…
  • Experiments in Science and Industry

    Kalpesh
    18 Jan 2015 | 11:47 pm
    We often see the use of experimental methods in not just research but also industrial settings. The purposes for the same may be very different sometimes. In the case of scientific research, the primary goal is to bring out the statistical significance of an effect that has been exerted by on the dependant variable by the independent variable. When we talk of industrial setting, the main goal is to draw out the maximum amount of unbiased information in context to the factors that affect the production process from as few observations as it is possible. In the case of scientific research, the…
  • Random Effects Model and its Importance and Usage

    Kalpesh
    12 Jan 2015 | 1:01 am
    Experimentation is often thought to only involve the manipulation of the levels of the independent variables and also the observation of the responses that come upon the dependant variable. Those independent variable levels are determined by the researcher and the effects they generate are called fixed. Other than these fixed effects, there is a class of effects that is not fixed but is of interest to the researcher. These are the random effects. These are the classification effects and the levels of effects are assumed to be selected randomly selected from an infinite population of the…
  • Advantages of the use of Cross Tabulations in Survey Analysis work

    Kalpesh
    4 Jan 2015 | 8:51 pm
    When we do conduct survey analysis, cross tabulations are often used for the purpose of analysing the relationship that exists between the variables. It is a means for analysing and doing comparison of the results of one or more variable with the output of another variable. In most of the survey reports that we see the output that is presented in the results is often given in aggregate only. The data tables that are there bare based on the entire group of the respondents. Where cross tabs help here is that they present the results from the group as a whole and along with that the results from…
  • Relationship between variables: Scope of Multiple Regression

    Kalpesh
    28 Dec 2014 | 9:05 pm
    The usual purpose of Multiple Regression is to understand the relationship that exists between the independent variables and the dependant variables. This kind of analysis is seen having its application in all industries.  For example, in the real estate industry, the agent might record for each listing the size of the house. The general purpose of multiple regressions is to learn about the relationship that exists between the independent and dependant variable which can also be termed as predictor and criterion variable respectively.  Coming back to the example of the real estate industry,…
  • add this feed to my.Alltop

    Tales of A Federal Government Contractor

  • My Mama Didn't Raise A Fool. I Ain't Goin’ Out Like No Punk.

    22 Jan 2015 | 10:34 pm
    I realized during my last blog, that I had never mentioned that profanity was not permitted on our government contract.  Profanity is not usually encouraged in the private sector either, but they are not usually strict about usage.  On my first government contract, we actually had a workshop on proper behavior in the workplace, internet use and profanity.  These issues were mentioned in our hiring contract; however an incident must have occurred because this topic was brought up again with policies that were stricter than before.  For example, profanity on…
  • Mucking Around

    19 Jan 2015 | 10:36 pm
    Every once in a while when I was really busy, I liked to take a short break.  Usually, I would go to Angela’s desk and just talk or maybe be silly for a while.  I wouldn't do too much because at this time, Angela’s desk was right next to Keith’s office.  However, that usually didn't stop me from having a little fun.  One day I went over to Angela’s desk, and there was a lot of commotion in front of Keith’s office.  The Infrastructure engineers and some of the managers were in front of his office.  They were upset because Keith…
  • Angela’s Story

    11 Jan 2015 | 11:58 pm
    Angela and I met after she had been rehired onto our project as a tester.  Her office was right across the hall from mine.  She seemed fairly nice.  Usually the first few weeks, you have some time to ease into your new job.  The drama does not usually start until about after a month or so.   However, this was not Angela’s fate, drama started after the first week.  One of the testers did not want to come in at 3 am to start testing and since Angela was new, they decided that she should do it.  When Angela was approached she explained that she needed 24…
  • You can’t say? What do you mean you can’t say??!!

    27 Dec 2014 | 9:08 am
    As I started getting more responsibilities on my first contracting job and my time seemed to shrink.  So, I began to work overtime and also I began to appreciate working late in the evening or on the weekend because most people were gone and I could get work done.  One night I was still working at 8:00 pm and my phone rang, the caller ID said US Government, so I knew that it was the client.  But, this was really odd, because most government workers come in to work early and they are usually gone by 4 or 5 pm.  At first I thought that it was probably a wrong number, so I…
  • Well, there is crazy and then there is just plain stupid…Boundaries!!

    26 Dec 2014 | 1:06 pm
    I never really talked or dealt with my boss on a personal level, because it was inappropriate, and I didn't really want to know.  However, there were some things that were known.  First, when Keith got hired he was going through a divorce.  Divorces can be difficult and they are like snowflakes, no two are alike.  However, I did not talk to him about it, because it was inappropriate and I had just gotten a divorce 3 years prior.  It was still too soon for me to talk about relationships, much less divorce.  One day he started talking to me about his…
Log in