Technical Writing for Business People

AFTERWORD

Have you ever made pasta from a recipe? If you have, you’ve probably encountered a great example of poor technical writing.

Many recipes will tell you to cook your pasta in salted water. But very few of those recipes tell you how much salt should be in that water. And that’s crucial information because if your water isn’t salty enough, your pasta won’t have that authentic flavour. The oft-quoted ‘as salty as the sea!’ explanation isn’t helpful either unless you happen to have some sea water handy for comparison.

How much salt should we use?

Good technical writing would give the harassed cook the fastest answer – a teaspoon and a half per litre – and provide more detailed information for cooking geeks like me who have more than one ...