TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Dick, I am not sure what your role is. Are you the
project manager or tech writer or developer? You said
you captured the functional requirements. Are you a
business analyst?
--- Dick Margulis <margulisd -at- comcast -dot- net> wrote:
> This is not a job posting. I wouldn't wish this job
> on a friend, and I
> consider all of you friends--almost all, anyway.
> What I'm looking for is
> help in crafting a job description that I will post
> elsewhere.
>
> Here's the situation:
>
> I have a client-from-hell who nonetheless pays well;
> so I keep doing
> stuff for her. The current challenge is that she
> (big-right-brain,
> non-linear, writing-challenged person that she is)
> is the SME for a
> software product she has conceived and is trying to
> extrude from her
> head onto paper, so it can be developed. She is in
> LA, I am in New
> Haven, and I can hear her waving her hands over the
> phone. She's not
> really an email person.
>
> I've captured as many of the functional requirements
> as I can. However
> the business logic layer is a highly complex expert
> system.
>
> At one point a few years ago, someone the client
> hired did some
> flowcharts to try to represent the logic of the
> system. I'm not
> convinced either that a logic flowchart is the best
> way to represent the
> system or to communicate it to today's developers.
> But I'm also not sure
> that it isn't.
>
> I know we've had many threads on other ways of
> representing systems
> graphically, varying with the frame of
> reference--UML(?), DFD, etc. I'm
> not adept at any of them, and there's the
> hand-waving thing and the
> client-from-hell personality thing that also
> mitigate against my doing
> this part of the job myself.
>
> So I know I need to find someone who is patient and
> skilled at
> extracting information from a difficult SME and who
> can work
> face-to-face with her in LA for the several days it
> will take to extract
> the information from her. But what I don't know is
> what technical skills
> I'm looking for in terms of the best way to
> represent an expert system.
>
> To clarify, this is for a functional spec, not a
> design spec. So the
> idea is to represent the needed logic at an abstract
> level, not to
> specify the design of the system to implement it.
>
> Any suggestions?
>
> Dick
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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 includes a one-click RoboHelp project
> converter. It's that easy. Watch the demo at
>http://www.componentone.com/TECHWRL/DocToHelp2005
>
> ---
> You are currently subscribed to TECHWR-L as
> swaller_2000 -at- yahoo -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/swaller_2000%40yahoo.com
>
> To subscribe, send a blank email to
> techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to lisa -at- techwr-l -dot- com -dot-
> Visit
>http://www.techwr-l.com/techwhirl/ for more
> resources and info.
>
>
Sincerely,
Sonja
Skillful speech not only means that we pay attention to the words we speak and to their tone, but also requires that our words reflect compassion and concern for others, and that they help and heal, rather than wound and destroy.
__________________________________________________
Do You Yahoo!?
Tired of spam? Yahoo! Mail has the best spam protection around http://mail.yahoo.com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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