G+G logo    

Gordon & Gordon is a partnership of two award-winning writers who specialize in technology, Gordon Graham and Manuel Gordon. Our clients hire us to explain complex products and to persuade demanding customers. And we share our many years of experience through practical, cost-effective consulting and training.


         

Good-Enough Documentation

Click any link to see more about this popular workshop:


Workshop Outline

Few people read your technical writing like a good book.

Instead, they skim, scan, and skip for the information they need to solve their problem and get back to their job.

Today's successful software publishers release "good-enough" software, and writers need to produce "good-enough" documentation to ship with it.

During this workshop, we present our minimalist, reader-centred approach to technical writing.

Our advice is based on actual, successful practices of real technical writers working on real software development projects. And on the lessons software developers themselves have learned in their projects.

This workshop will help experienced writers learn new approaches and work more effectively by facing "the real world" as it actually is.

And it will equip newer technical writers with a solid, practical approach that will enhance their success in the field.


Who Should Attend

  • Experienced technical writers who recognize that good writing alone does not guarantee success
  • Newer technical writers who want to ensure their success in the field
  • Technical writers, editors, and managers who face growing pressures to do more with less

What You Will Learn

  • The 5 dirty secrets of technical writing in the real world
  • What Sam Spade teaches us about technical communication
  • How to Understand, Simplify, and Explain
  • If they need it, they will come:
    why good content matters most
  • Why minimalism means more than "cutting out text"
  • Deciding what to document, and what to leave out
  • How to quickly integrate audience analysis and task analysis into your plans
  • Using today's software development strategies:
    prototyping, incremental releases, iterative development, staged delivery
  • Planning and estimating a documentation set
  • Creating and using a style guide
  • Staking out your turf in development projects


What People Say About This Workshop

"Good case studies. I love having 'real-life' examples."

"Lively discussion among a group of peers."

"I especially appreciated the 'good-enough' approach."

"I learned quite a bit about ways I can improve my documentation."

"Interesting and relevant."

"I felt very comfortable in the class because open discussion was encouraged."

"I'm looking forward to your next workshop!"


Can't Wait for the Next Workshop?

Order the Workbook!

If you can't wait to find out more, why not order the workbook?

The "Good-Enough Documentation" workbook includes all the slides, exercises, and bibliography distributed during this workshop for just $49.95 plus shipping & handling.

SPECIAL: Now this workbook comes bundled with the "Technical Writing 101" workbook at no extra cost!

Click here for more information about the workbook.

To BUY this workbook right now using a credit card,
click on your place of residence:

Click here for additional ordering information and options.


How to Register for this Workshop

If you'd like to be notified when this workshop is next held, click here to email us.


Need Help Getting Started?

Gordon & Gordon don't just teach, we also do!

If you need help getting started with your documentation project(s), we'd be happy to talk about coming in for a short project. We can do planning and outlining for your documentation set, help you hire staff and set up workflows, or anything else you might need.

Call us today to see how we can help.


How to Contact Us

small photo of Manny

 

How to reach
Manuel Gordon

Tel: (514) 934-3274
Email Manny

small photo of GG

 

How to reach
Gordon Graham

Tel: (705) 842-2428

Email Gordon