RE: Documenting A Ballet Dance
From: Tony Markos <ajmarkos -at- yahoo -dot- com>
To: Bonnie Granat <bgranat -at- granatedit -dot- com>,'TECHWR-L' <techwr-l -at- lists -dot- techwr-l -dot- com>
Subject: Documenting A Ballet Dance
Date: Mon, 12 Dec 2005 11:36:34 -0800 (PST)
Bonnie:
For a ballerina, the dance is her product. Tech comm
is about documenting a product - it is not the
ultimate product in itself.
By the way Bonnie, what is the best way to document a
ballet dance? To quote Ed Yourdon: "Procedure is like
dance: It defies written description". What Yourdon
means is that, like a software system, dance is
asynchronous (multidimensional): Many potential things
happening at the same time, and often complex
branching. Using text to try and document dance is
attempting to use a one-dimensional tool to document
multidimensional entity. To properly document a her
ballet, the ballerina primarily needs diagrams.
Tony Markos
--- Bonnie Granat <bgranat -at- granatedit -dot- com> asks:
How does that differ from judging a ballerina by her
ability to draw diagrams of her movements?
In response to Tony Markos writting:
This explains the fallacy of writing skills tests: You
are testing for implementation skill - a much lesser
skill - not for analysis skill. The real test is to
ask the person being tested to create what he/she
would use as input to text creation - not
to create text.
_________________________________________________________________
Express yourself instantly with MSN Messenger! Download today - it's FREE! http://messenger.msn.click-url.com/go/onm00200471ave/direct/01/
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author content and configure Help in MS Word or any HTML editor. No proprietary editor! *August release. http://www.componentone.com/TECHWRL/DocToHelp2005
---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
To unsubscribe send a blank email to techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.
Follow-Ups:
- RE: Documenting A Ballet Dance, Bonnie Granat
References:
Documenting A Ballet Dance: From: Tony Markos
Previous by Author:
RE: Help & Manual questions.
Next by Author:
Re: Structuring Documentation
Previous by Thread:
Documenting A Ballet Dance? (take II)
Next by Thread:
RE: Documenting A Ballet Dance
Search our Technical Writing Archives & Magazine
Visit TechWhirl's Other Sites
Sponsored Ads