How To Mind Your Grammar On The Web

Ben Parr (Mashable) asks: “Say your project manager comes to you with his proposal that will be going out to investors, business partners, and potential clients. Then you find that your manager has used “4” instead of “four”, “r” instead of “are”, and abbreviations such as lol, atm, and idk. How would you react? “

Top 50 Technical Writers on the Web

I’ve made a list of the top 50 technical writers with a web presence. Some of these you might know, such as Darren Barefoot and Tom Johnson. I have also added some other writers from India, Russia and Israel to reach out to a wider audience. I’m sure there are others that I’ve missed. Let me know and I’ll update the list.

Common errors in technical writing

Intrepid offier notes from a session of the Mumbai chapter of the Society for Technical Communication. The first session was by Gurudutt Kamath, who is probably the most well-known figure in the tech writing community in India. “My interest in attending the session arose cause someone I know was also speaking there, and also because […]

7 FrameMaker Fails

Kohsuke Kawaguchi explains just why FrameMaker is so brain-dead. He explains why not to use FrameMaker and lists some of its problems: No undo stack No color No mouse wheel support Windows 95 UI No keyboard shortcuts Font selection via menu Resizable dialog that doesn’t expand controls.  

How to Optimize PDF Files for Blogs

What’s the best way to optimize your PDFs for blogs and websites? While PDFs have become quite popular on the Web, many PDFs used in web sites are designed for high quality print output and are not optimized for the Web. Even PDFs designed for Web use can have a wait problem, weighed down with excess […]

Difference between Usability and Information Architecture

Though the terms Usability and Information Architecture are often understood to be the same thing, this is not true. Usability This tends to study a person’s ability to do (i.e. use) something, such as reading text on a webpage. Usability is not restricted to the web and is used across many industry sectors. For example, […]

What do Information Architects do?

An Information Architect organizes a website so that users have a better online experience. In general, their main responsibilities are to: Assign tasks to team members. The Information Architect often doubles up as the Project Manager. Capture the site’s design goals. Communicate the business objectives, such as the site’s sales targets, audience, and language requirements. […]

Why Table of Contents Don’t Display in MS Word

In Word, the Table of Contents is not displayed. Instead, I get an error message: { TOCO “2-4″H Z T “HEADING 1,1”} Ivan – I think the problem is to do with Field Codes, so here’s a few suggestions. 1. In Word, go to Tools > Options > View tab and click off Field Codes […]

Age Discrimination in the IT Industry?

I receive about 20 CVs every month from writers looking to either supplement their income as freelancers or look for new opportunities in the tech writing field.   A common thread among many of these letters is from individuals who are finding it increasingly difficult to increase their earnings once they get over 40. Their […]