Posted in Uncategorized

Are you ready for the future of content?

Larry Kunz has written a great article about the disparities coming up in content writing, and how we can start to fix it.

I recommend reading:

Are you ready for the future of content?.

Posted in Uncategorized

Join me at the STC-PMC 2014 Mid-Atlantic Conference!

STC-PMC logo

One of the things I like about the STC having a chapter set-up is that even if the closest chapter isn’t next door, it’s usually still close enough to find people from your region with whom you can connect. For me, I found my “tribe” with the STC – Philadelphia Metro Chapter, or “STC-PMC” as we call it.

Every year, the STC-PMC hosts a Mid-Atlantic Technical Conference that people from around mid-Atlantic region–and beyond–come to learn and present information going on in the world of tech comm. My first exposure to tech comm conferences–and presenting–was at last year’s STC-PMC conference, and it was just a positive experience. I met many people whom I had only known through social media, and met new people as well. Philadelphia is known as the “City of Brotherly Love”, and it’s evident with this STC chapter. I immediately felt welcomed both as a member and as a new presenter as well.

The conference itself opened my eyes to new possibilities and new ideas as well. I also felt that it validated many of my own experiences as well–that I was coming up with similar ideas and solutions as others in the field. I also liked that unlike the STC Summit or some of the other conferences I’ve been to, this one is a little smaller and more intimate, allowing everyone the opportunity to get to know the speakers and the other attendees on a more one-to-one level.

This year’s STC-PMC conference is on Saturday, March 22nd just outside of Philadelphia in Willow Grove, PA. This all-day event is going to be jam-packed full of good information that’s timely and will be helpful in your tech comm evolution. I’m presenting this year, and my presentation is called, “Blogging Out Loud: The Basics of Blogging.” It seems I know a little something about blogging and am willing to share. 🙂

But I’m not the only draw–Neil Perlin, STC President Nicky Bleiel, Ellen Buttolph, Roger Renteria, Ben and Marilyn Woelk, Donn DeBoard, Todd DeLuca, Traci Browne, David Dylan Thomas, Bernard Aschwanden and Christopher Ward will all be presenting as well. There’s lunch, prizes, and lightning talks, too! All at a very affordable price!

Afterwards, there will be a free networking event at the nearby Iron Abbey restaurant sponsored by WebWorks and Publishing Smarter. (You don’t need to go to the conference to attend the networking event, but you’ll get more bang for your buck if you do both!)

So, it’s a fantastic event that the STC-PMC is setting up, and gee–it’s on a Saturday! You don’t have to worry about missing work to take advantage of this great networking and learning opportunity.

If you’re relatively nearby and want to participate, there’s still time and still some spots left! Register today by going to http://www.stcpmc.org/conference.

You won’t regret it! (And if you do come, make sure to seek me out and say hello!)

Posted in Uncategorized

Douglas Adams Knew Tech Comm Before It Was Cool

Photo taken at the Computer History Museum in California by me! Who knew it'd be back in the news?
Photo taken at the Computer History Museum in California by me! Who knew it’d be back in the news?

At the end of my trip attending the Intelligent Content Conference in San Jose, California, I had the opportunity to visit the Computer History Museum in nearby Mountain View with a group of other conference attendees. It was a great little excursion, especially for a geek mom like me. Every kind of computing device in the last 150 years (give or take) was included in this place. I felt particularly old when seeing several of the first computing toys like “Merlin”, “Donkey Kong”, and “Quiz Wiz” displayed (I had one of them, my sister had another, and I wanted the third!) I also saw some of the earliest versions of Apple and PC computers. I remember them as well. My father brought home an Apple II from the school where he was an administrator, and I remember playing some of the earliest versions of Castle Wolfenstein and doing simple computer graphics in BASIC on it. Good times.

4thDrImageAdams
Tom Baker as the 4th Doctor on Doctor Who. He later starred in Adams’ “Hyperland” video as the interface.

But one items caught my eye, which was the game shown in the image above. It was the computer game of “The Hitchhiker’s Guide to the Galaxy” from 1984. My own disclaimer is that I’ve never read the book or played the game, but I’ve watched the movie and enjoyed it. I also know that the author of the book, Douglas Adams, was an occasional writer for Doctor Who for a time, so seeing this computer game picqued my interest. I also remembered that Douglas Adams wrote and created the mini-movie called, “Hyperland”, which starred the former Fourth Doctor, Tom Baker, and talked all about hypertext theory. See my post about it here. If you haven’t watched it, you must take the time to do so, as it still stands the test of time and is well done! It occured to me that Douglas Adams really understood the idea of hypertext when he wrote “Hyperland” due in part to Doctor Who, simply because the entire show is actually all HYPERTEXT. While it seems that we are going forward in a linear way, we are actually pulled back and forth into different times and sequences–much like hypertext.  Think Elizabeth I references throughout or that the Doctor can be in several places at once–he may be in Victorian England as one version of himself, while in Victorian England as another version in another part of the country on the same day, for all he knows.  Same story of the same man (essentially), but two different directions.

But anyway, I digress. I thought it was really cool to see this old game displayed at the museum, and didn’t think anything more about it until I saw this article come out:

BBC Revamps ‘Hitchhiker’s Guide to the Galaxy’ Game

What’s this? Evidently, the BBC is revamping and re-releasing the game as a 30th Anniversary edition. Who knew that an old game written by Douglas Adams, who understood hypertext theory before it was mainstream, would stand the test of time? I’m excited that it’s out, and have played a round already. It’s good fun. Go to the link above for the article, and find the game on the BBC website. It’s a great example of the use of hypertext writing well before people started to understand how to structure content and employ reuse on the Internet. Give it a try. You’ll enjoy it!

Posted in Uncategorized

Content Strategy practices are not hard!

pulling-your-hair-out-girlWhile I haven’t been an official content strategist/publisher for that long, I actually have been web publishing for a long time now. Over the years, I’ve learned the difference between good practices and bad practices, from experience and through classes and webinars I’ve taken. I’d like to think that from all of this that I’ve learned to be a pretty good content strategist and web publisher. Even so, I still don’t understand why people find content strategy difficult to understand, and why creating a high standard of quality in content strategy and publishing content that’s user-friendly is so difficult. It makes me want to pull out my hair it frustrates me so much!

A recent occurrence of this lack of comprehension spurred my intense frustration again. I’ve experienced this before in many places that I’ve worked, but this was just the latest occurrence that sparked my ire.  Among several projects that I’m working on at work, one of them is managed by another web publisher. In our project, we’ve been assigned to revamp a current internal website. Par for the course–this is what we do. The project manager was given an outline by the internal client, along with the main content, which included documents to be linked within the pages. That sounds fair enough. Of course, as most technical communicators know, content written or planned by non-technical communicators usually needs some help to make it more user-friendly.  In this case, much of the formatting of the content was…less than desirable. In addition to making the outward facing part of the microsite user-friendly, we also had to make the back end–the organization in the content management system–user-friendly as well, since the client would be maintaining the site after we were done setting it up. This all sounds like a reasonable task, and a technical communicator would be just the person for the task.

However, I found myself frustrated with the process, or rather, the quality of what was starting to go up. The project manager gave me sections of the website to work on and format. I found it difficult to decipher the client’s outline because the outline was written poorly. Nevermind the actual text itself, which wasn’t always well written either. I couldn’t really touch that. The outline was meant to help the web publishers–the project manager and I–understand how the client wanted the site organized. At a high level, the main outline seemed fine, but when getting into the finer details, it easily fell apart for many sections. I often had to consult the project manager for clarification, as I wasn’t supposed to be talking to the client directly, for some reason. Whatever.

The other problem was that nothing was labelled in a way that made sense or was user-friendly for use on the front or back end. I can understand that people have different naming conventions for files that make sense to themselves. But when creating the name of a file that is some sort of document or form to be used by others, and not giving the document a title? I don’t get that. For example, if the document is a quick reference guide about how to use your Lotus Notes account, then the text on the web page should be something like,

Quick Reference Guide for Lotus Notes

and the file on the back end should be called something like, “QuickRefGuide_LotusNotes.pdf,” or something like that in order for the user to understand what they are downloading. The file shouldn’t be called something like, “QFC-LN_ver1_01.02.14.pdf”. Down the road, someone will look at that downloaded file and question what that file is. Wouldn’t it be easier to title the file more appropriately rather than have to open it?  I’m sure some would argue something about versioning here, but in our CMS, there seems to be a bad practice of putting many versions of the same document up with different names rather than utilizing the versioning function of the CMS. I use the versioning function on the CMS extensively on the other sites I work on, so this confuses me that others think it’s okay to clutter up the system with many versions of the same file under different file titles.

To add to the grief, the client sent files in zip files which yielded unorganized folders and files as well. In this instance, the project manager would keep the folder convention the client had given, even when it didn’t make sense. When I questioned the project manager, I received the response of, “The client had them organized that way, so we’ll leave it because they’ll be maintaining it later.” NOO!!! The organization didn’t make sense, it didn’t follow the client’s own outline, and complicated the back end so that it didn’t make sense! I am confident that the client just slapped some folders and files into a zip file, and sent it along for us to decipher it. I spent the past year cleaning out another department’s very large microsite doing just this–giving files more appropriate names and creating a folder system that would make sense to ANYBODY going into the site to find the page or document needed that followed what was on the front end. And now, when changes need to be made, it’s easy to find the appropriate documentation.

As I’d do the pages I was assigned to do for this new microsite, it became clear to me that the project manager didn’t care. Granted, it’s a big project, and we want to get it done quickly. It would be easier to be able to merely cut and paste content into the site and be done, but it’s also our responsibility as content strategists and technical communicators to make things easier, more streamlined, more user friendly for both the front end and back end.  The mantra for all technical communication is always user advocacy– for all aspects of the project, whether it be digital or print.

This means that there needs to be attention to details, thus the “copy and paste” method of entering content into a CMS system alone is not enough. I used to be known at one job as the “Table Queen” because the CMS used didn’t like the copy and paste of tables from Word, so I usually had to go into the HTML code and fix everything so it displayed correctly–or if I could, make it display even better.  Tables are something simple to figure out in HTML, but even so, it was something that other people at that particular job with the title of “web publisher” did not know. (They didn’t even know HTML at all, so why were they called “web” publishers?) It was important to make the pages look consistent and be organized in a way that would allow the users to find information quickly and easily.

In this project, I’ve found that the project manager isn’t taking the lead in setting the standard for the website. I’ve been disappointed that the same standards that I would expect aren’t being displayed by this person. It frustrates me, but like I said, it’s not the first time I’ve encountered this reluctance to make a website work.

Do understand that I’m not a perfectionist. I let things slide to a certain point, too, and post things that are “good enough”.  But in the end, it comes down to the foundation of the website. If the foundation and the building blocks aren’t sound, it’s not going to hold up. In content strategy, if the infrastructure of the site isn’t sound, and the content isn’t well defined, then the website will reflect that disorganization.

Content strategy, at its core, is really easy. It’s all about organizing information in a way that it can be easily searched and retrieved. It’s about labelling files and folders so that they make sense.  Val Swisher’s analogy about content strategy being like one’s closet still stands at the heart of it.  If you can organize your closet and identify the different clothing pieces in order to categorize them, then you understand how to do content strategy. The only difference is that instead of having shirts, skirts, pants, and shoes to organize, you have folders of documents, webpages, and multimedia.  The method of making sure that users can find those documents, webpages, and multimedia should be streamlined, clear, concise, and user-friendly. As content strategists and user advocates, it’s all about making sure that what the audience is viewing looks and reads well, and what the content managers can maintain easily.

Ultimately, when creating a content strategy and setting it up for maintenance, do it correctly now, even if it’s time consuming. If for no other reason, it’ll save time and headaches later. It’s not difficult. It’s just common sense.

Posted in Uncategorized

Content Strategy and the Royals

KateWillsIt was recently announced that in the UK, the Royal Family was going through a bit of a corporate merger and restructuring, one might say. Her Majesty The Queen is getting up there in age (she’s almost 88 years old), and while she still maintains a full schedule that probably would put people half her age to shame, it was announced that her communications office and the communications office of her son, HRH The Prince of Wales, would be merging. This inferred that 65 year-old Prince Charles, who’s of retirement age himself yet shows no signs of slowing down either, is slowly going to be taking on more affairs of the regency on behalf of his mother. While the Queen has vowed never to abdicate or give up the throne (and if she lasts as long as her own mum, that could be another 15 years), it looks like she might be winding down to a point that she is slowly transitioning the affairs of state to Charles, as well as delegating responsibilities to her grandchildren as well. According to the Sunday Telegraph, “Reports suggest the move should avoid clashes of coverage of royal events as younger royals perform more engagements, and spread expertise in modern media.”

For more information, read this article.

Even HRH Prince Charles is wondering how this transition relates to content strategy. "Do tell, TechCommGeekMom."
Even HRH Prince Charles is wondering how this transition relates to content strategy. “Do tell, TechCommGeekMom.”

So, all this is fine, but what does this have to do with content strategy, you may ask? Simple. This scenario really isn’t that different than any other company having to merge content written by different departments, like that of technical content writers and marketing content writers. Everyone in the merger or restructing needs to speak the same “language”, or to use a better description, they all need to use the same terminology. One of the issues that has been surfaced in recent tech comm talk in conferences and blogs is the idea of “silos”–different departments writing content, but not getting together to make sure that everyone is using the same terminology and language to communicate the company message consistently. This can lead to mixed messages in print, in multimedia, and online very quickly if everyone isn’t on the “same page”. Joe Gollner’s Adobe Day-Lavacon 2013 talk came to mind as I was thinking about this merger, and what it meant to have different departments sending out different messages.

Don't think too hard about it, Prince Harry. It's really not that complicated.
Don’t think too hard about it, Prince Harry. It’s really not that complicated.

So, the merger of the royal communications offices makes total sense, really. In an age where news is spread quickly throughout the internet, especially through social media, it seems like a proactive move on the part of the royals to start this transition. One office will need to juggle multiple products–in this case, the royal family members–by providing a single voice and consistent message to promote their activities or relevance, whether it be in print or by digital means. The royals are already a bit ahead of the curve of many corporations, having already set up fairly active websites and social media presence on the internet. They even have their own YouTube account and several Twitter accounts, for example! The communications offices are already on top of internet media, and this step seems like a modern move that many companies are still hesitant to make.  Perhaps the royals, known for being a bit stuffy and overly traditional, might actually be cutting edge, and setting the example of how to move forward in the 21st century.

It’s something to think about.