A Technical Writer’s Bookshelf

Books. Yes, real books.  Black and white ink printed on paper.  I am a purist and one of the last remaining proponents of reading actual books.  No matter how cool, convenient, or affordable the eReaders get, I refuse to ever get one.  I like the experience of physically holding a book, turning the page, and writing notes in the margins.

I take books with me on airplanes and when everyone else has to turn off their electronic devices, I can still keep reading.  The battery on my book will never die, the hard drive will never crash, and water spilled on it will not ruin it. In fact, the older and more wear and tear that a book has makes it more valuable to me because it shows the character of the book.

Call me a curmudgeon, call me old fashioned, I don’t care.  One of my favorite things in life is the smell of an old book.  I love walking into a used bookstore, picking up a first edition, opening it to the middle, and planting my face in between its pages.  The smell of an old book takes me away to a different time when there was a slower pace of life.  You just can’t get that from a kindle.

So naturally at my desk at work, I have a bookshelf that is chock-full of paperback and hardcover books. Below is a list of the books on my shelf at work, which I believe to be a Technical Writer’s bread and butter.  I reference many of these books on a daily basis.

Style Reference Books

  1. Microsoft Manual of Style – Fact. Every technical communicator should have a copy of this book. It is 100% essential to producing quality (and correct) end-user documentation.
  2. Chicago Manual of Style – Goes hand-in-hand with the Microsoft one.
  3. AP StyleBook – If you are doing any sort of journalism or writing articles, you need a copy of this to reference as well.  These two styles are completely different and it is extremely valuable to know the difference.
  4. The Elements of Style By William Strunk, Elwyn Brooks White – The quintessential style reference book. Another must-have for any style of writing.
  5. HTML Manual of Style – Good for anyone who works with HTML.
  6. Merriam-Websters Dictionary and Thesaurus – Even though the internet can rapidly define almost any word, I still use this because it is more accurate.

Web Design/Usability/User Interface Books

  1. Don’t Make Me Think: A Common Sense Approach to Web Usability By Steve Krug  – If you are working in web design in any capacity, this book is a must-have.
  2. How to Design and Write Web Pages Today By Karl Stolley – A really good approach to writing web sites by today’s standards.
  3. User Interface Design for Programmers by Joel Spolsky – a little more technical than the others, but it provides a ton of great information.
  4. The Design of Everyday Things By Donald Norman – A great book that will forever change the way you think about design.
  5. Head First HTML, CSS, & XHTML – This is a phenomenal book that teaches even the most non-tech savvy person how to make websites from scratch.  I love the Head First books because they present the information in such a user-friendly and easy to understand way. I highly, highly recommend.
  6. Head First Javascript By Morrison
  7. Head First jQuery By Benedetti & Cranley
  8. Adobe Classroom in a Book: InDesign – I highly recommend these books if you are going to teach yourself how to use the Adobe Creative Suite.  Their instructions are very good and they come with CDs.
  9. Adobe Classroom in a Book: Illustrator
  10. Adobe Classroom in a Book: Dreamweaver
  11. Writing Effective Use Cases by Cockburn – If you’ve never written a use case before, you will benefit from this book.
  12. Software Engineering: A Practitioner’s Approach by Pressman – This is a good book if you are new to Software Development (as I am).

Marketing & PR Books

  1. Crossing the Chasm by Geoffrey Moore – This book explains the Technology Adoption Curve that I talked about in an earlier post.  It is really interesting and helps you understand how the general public encounters new technology.
  2. Inside the Tornado by Geoffrey Moore – This book explains more about the chasm as well as going into detail about Value Propositions.
  3. The Idea Writers: Copywriting in a New Media and Marketing Era By Theressa Iezzi

Fiction

I also have the Hunger Games series on my shelf.  Because, it is one of the best fictional series I have ever read.  Fabulous.  I highly recommend it.  Fiction is my favorite genre of books to read for pleasure.  I usually buy paperback or hardcovers, but I also occasionally will listen to an audio book from Audible on my iPod at the gym or on cd in my car from an audio book I checked out from the library (yes, people still check out books from the library).  I am starting The Girl with the Dragon Tattoo series this week.  What’s on your bookshelf?

Web Design and Technology for Tech Writers

In today’s “digital age,” it is essential for a Tech Writer to have a working knowledge of web design concepts and emerging technologies.  This field, like many others, moved to the web about 10+ years ago when almost all other written content went electronic.  The entire field has radically changed in that time.  Everything has gone digital.  Yes, some companies still publish printed manuals, but most of the documentation is now digital and web-based. That’s why tech writing isn’t for everyone, because not only do you have to be a skilled writer, but you have to understand technology because you will be engaged with it on a daily basis. 

This comes relatively easy for me, because I grew up with technology as part of my everyday life.  I knew the importance of learning new technologies for success in today’s workplace and made sure to keep my skills current.  Most people fall in the early or late majority of the Technology Adoption Curve (below). Innovators are the people who wait in line to get the latest iphone, early adopters quickly buy and use the latest technology in their daily lives, the early majority is risk adverse and somewhat skeptical, they will wait for the next release when all the bugs are worked out or when the have read enough positive reviews, the late majority are the people who refuse to use a smart phone or use facebook, and the laggers are the people who refuse to own a home pc or a cell phone.  There is a chasm between the early adopters and the early majority where a lot of new technology falls.  Tech writers need to be early adopters to be on the cutting-edge of the field.

When most people start using a product for the first time, they generally just want a Quick Reference Guide or Quick Start Guide; just something that tells them the basics of how to get started.  No one wants to read a 200 page manual.  The most people will do is go through the online help, but only after they have run into a problem or are trying to do something that isn’t obvious.  So, writers have to find creative ways to make information stand out and be accessible to readers.   

For most products, the entirety of the user documentation is housed online.  Therefore, tech writers need to understand web design and how to author web-based materials.  There are many different help-authoring tools on the market right now that provide the writer with a relatively simple way of publishing online content (Flare by MadCap, RoboHelp and Framemaker by Adobe, and Doc-to-Help by ComponentOne for example).  Often HTML and CSS are necessary to style the output and make sure that it displays correctly on a number of different outputs.  For instance, some of these programs allow you to design output for internet browsing on PCs, iPads, and mobile devices.

In my role, at a software development company, my web design knowledge-base spans past authoring web-based documentation and help content.  I assist in the QA process, update the website, and create documents using the Adobe Creative Suite (InDesign, PhotoShop, Illustrator, etc).  All of these things require a working knowledge of web design, user interface design, and programming languages. 

I have developed a list of the basic concepts, skills, or programs that every tech writer should know.

  1. Be able to read and write in HTML, CSS, and XML.  Knowledge of  XHTML, Java, and Javascript is beneficial as well.  HTML (hypertext markup language) is the backbone of any webpage. CSS (cascading style sheets) is the style of the webpage; colors, borders – how it looks.  If you do not know these programming languages already, I highly recommend picking up any of the Head First books and using http://w3schools.com to learn.  That’s how I learned.  All the web designers I know are self-taught.  You can easily teach yourself how to do all of this without taking an expensive college course.  It’s not as daunting as it seems.  These books walk you through it step-by-step in a very simple, and easy to understand way.  They also have the “answer” on their website so you can see how it is supposed to look as you are developing. 
  2. Use Content Management Systems (CMS) (WordPress, Joomla, Drupal, Dreamweaver, or others).  Almost every website was built using a CMS because hand-coding is tedious and time consuming.  Besides, these systems do most of the work for you (who doesn’t love that?) because they have built-in designs and themes.  They have two different ways of letting you write, edit, and design the content, either in a visual pane – meaning that you can you can see the content as it would appear on the web and click on icons to insert hyperlinks, make headings, etc, or HTML pane – which has the entire web page displayed in code for manual editing.  You can toggle between the two different views, as I often do.  Knowing html and css can help you make adjustments to formatting that might not be available in the visual pane. 
  3. Use File Transfer Protocol (FTP) – Used for creating and maintaining web pages.  FTP such as WinSCP and Filezilla, (which are both open-source programs -meaning free, non-proprietary), allow you to transfer your web design files (HTML and CSS code files, image files, etc) to the web host.  You can easily move files back and forth across two panes (one for your computer and one for the web host).  You use FTP in conjunction with CMS.
  4. Know the different image formats and when to use them.  Images can be displayed in a number of different formats on the web.  The five most common are .JPG (or .JPEG), .GIF, .BMP, .TIFF, and .PNG.  .JPEG is best for photographs.  .GIF is best for line art, logos or other simple images without gradients or varying color.  .GIF can use transparency and animation.  .PNG does not support animation, but does support transparency.  It creates smoother graphics than .GIF.  .TIFF files are very large files but they produce a very high quality image.  .BMP files cannot be resized and are not compatable with all platforms. The ideal image file size is about 20KB.  Any larger than 1MB will take a very long time to load.
  5. Study User Interface (UI) design as well as Web Design.  Every program or system has a user interface – where the user interacts with the machine.  Learning design principles will help you understand the inter-workings of programs and will make you a better writer.  UI will also help you write readable online content.  Some of the design principles that I live by include: keeping the column widths around 75 characters, font no smaller than 12 point, and line height around 20px to 26px, and having paragraphs contain no more than 3-4 sentences with frequent subheadings. 

The list grows as technology changes, but knowing these basics will ensure that you are on the cutting-edge and capable of handling almost any project that comes your way.