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:
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:
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!)

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.

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!
While 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.
You must be logged in to post a comment.