Comments on: Goal-Driven Documentation http://tynerblain.com/blog/2006/10/09/goal-driven-documentation/ Software product success. Tue, 22 May 2012 20:46:27 +0000 hourly 1 http://wordpress.org/?v=3.0.4 By: Laura Harley http://tynerblain.com/blog/2006/10/09/goal-driven-documentation/comment-page-1/#comment-141950 Laura Harley Fri, 31 Aug 2007 20:45:01 +0000 http://tynerblain.com/blog/2006/10/09/goal-driven-documentation/#comment-141950 Your articles is right on target. I couldn't agree with you more. Unfortunately, the principle in software is to write only about the tool, and not the job, because we in software can't really know what the actual job in a company might be. Somewhere, software requirements folks determined this was the correct approach. I argue with this all the time in developing help for software systems. So I agree with you. However, your article lacks research or specific information about users preferences for help, what works and what doesn't. Your logic, however clear to me, won't convince my managers. Your articles is right on target. I couldn’t agree with you more. Unfortunately, the principle in software is to write only about the tool, and not the job, because we in software can’t really know what the actual job in a company might be. Somewhere, software requirements folks determined this was the correct approach. I argue with this all the time in developing help for software systems. So I agree with you. However, your article lacks research or specific information about users preferences for help, what works and what doesn’t. Your logic, however clear to me, won’t convince my managers.

]]> By: Scott Sehlhorst http://tynerblain.com/blog/2006/10/09/goal-driven-documentation/comment-page-1/#comment-55647 Scott Sehlhorst Thu, 19 Oct 2006 14:09:19 +0000 http://tynerblain.com/blog/2006/10/09/goal-driven-documentation/#comment-55647 Hooray! Thanks Nils, you've made my day! And good luck with the doc, I think you're right - it will help a ton. Did you also check out the <a href="http://tynerblain.com/blog/2006/10/10/use-case-driven-documentation/" title="Use Case Driven Doc" rel="nofollow">Use Case Driven Documentation</a> article? Hooray!

Thanks Nils, you’ve made my day!

And good luck with the doc, I think you’re right – it will help a ton. Did you also check out the Use Case Driven Documentation article?

]]> By: Nils http://tynerblain.com/blog/2006/10/09/goal-driven-documentation/comment-page-1/#comment-55634 Nils Wed, 18 Oct 2006 20:57:53 +0000 http://tynerblain.com/blog/2006/10/09/goal-driven-documentation/#comment-55634 Scott - This post is so timely for me! I'm currently reworking the doc set for our product (Accept 360°) with these goals (and a lot of Kathy Sierra's ideas) in mind. It's a big change, and somewhat scary - not much of the current docs will be left by the time I'm finished, so it's all new work -- but I know it will provide a lot of value for customers and prospects evaluating the product. Scott – This post is so timely for me! I’m currently reworking the doc set for our product (Accept 360°) with these goals (and a lot of Kathy Sierra’s ideas) in mind. It’s a big change, and somewhat scary – not much of the current docs will be left by the time I’m finished, so it’s all new work — but I know it will provide a lot of value for customers and prospects evaluating the product.

]]>