[Author Prev][Author Next][Thread Prev][Thread Next]
[Author Index (this month)][Thread Index (this month)][Top of Archive]

Re: "use-case based documentation"

Subject: Re: "use-case based documentation"
From: Mike Starr <mike -at- writestarr -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 05 Feb 2015 14:00:52 -0600

You actually worked in an environment where they created a flowchart? I've been saying for years that if they made the development team create a flowchart *before* they began coding there'd be far fewer bugs.

I've worked in environments where there were no plans whatsoever... just a few developers who'd each get an idea for a feature and start coding. Totally seat-of-the-pants.

Best Regards,

Mike
--
Mike Starr, Writer
Technical Writer - Online Help Developer - WordPress Websites
Graphic Designer - Desktop Publisher - Custom Microsoft Word templates
(262) 694-1028 - mike -at- writestarr -dot- com - http://www.writestarr.com
President - Working Writers of Wisconsin http://www.workingwriters.org/

On 2/5/2015 12:33 PM, Keith Hood wrote:

"
Since we don't have use cases, design documents, or even what I'd call
proper user stories..."
Ye gods and devils, how the bleep do the developers work? Post-it notes on top of a whiteboard diagram? (I've actually seen that. The entire design guidance was a flow chart drawn on the wall, and whenever someone thought of some nuance, they'd either write something under a node or they'd stick written notes to the diagram. As you can probably guess, documentation was not a high priority with that bunch.)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy & Procedure Guides, eBooks, and more using Microsoft Word | http://bit.ly/doctohelp2015

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives

References:
RE: "use-case based documentation": From: Margaret Cekis
Re: "use-case based documentation": From: Keith Hood

Previous by Author: Re: Tech Writing tools and Windows 8.1 migration
Next by Author: Re: Colours in Windows 8 screenshots
Previous by Thread: Re: "use-case based documentation"
Next by Thread: Re: "use-case based documentation"

[Top of Archive] | [Author Index (this month)] | [Thread Index (this month)]

What this post helpful? Share it with friends and colleagues:

Sponsored Ads