Popular Threads From TECHWR-L:
List Statistics
- Total Threads: 1688
- Total Posts: 2667
Phrases Used to Find This Thread
|
# 1

13-07-2011 01:19 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 2

13-07-2011 02:04 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 3

13-07-2011 02:08 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 4

13-07-2011 02:10 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 5

13-07-2011 02:13 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 6

13-07-2011 02:13 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 7

13-07-2011 02:24 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 8

13-07-2011 02:29 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 9

13-07-2011 02:48 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The engineer might be interested in your input if you can get involved in the project early enough in the process.
If you want to propose design changes after several test cycles, you have to accept that the engineer
might not be able to address your suggestions until the next version.
------------------------------------------------------------
Ruth Sessions
603/886-7355
________________________________
From: "Cardimon, Craig"
To: 'Kerstin Peterson' <>; "'techwr-'"
Sent: Wednesday, July 13, 2011 9:24 AM
Subject: RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 10

13-07-2011 02:54 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The engineer might be interested in your input if you can get involved in the project early enough in the process.
If you want to propose design changes after several test cycles, you have to accept that the engineer
might not be able to address your suggestions until the next version.
------------------------------------------------------------
Ruth Sessions
603/886-7355
________________________________
From: "Cardimon, Craig"
To: 'Kerstin Peterson' <>; "'techwr-'"
Sent: Wednesday, July 13, 2011 9:24 AM
Subject: RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've grown to detest the moniker "SME" as it takes the human
completely out of the equation.
Here are some real tips:
1) The "SME" is a human being who was tasked to deliver a portion of
the overall project, just like you were with the documentation.
2) The "SME" generally has interests outside the project and more
often than not enjoys conversation with other co-workers and project
team members. Try it sometime.
3) Both you and the "SME" have the same interests in mind. Both of you
will put the user first, but in your hearts you know you're excited
about the next paycheck.
4) The "SME" may not be a SME about much of anything. They may know
less about the user than you do. They might be a SME in C# or other
such technology, but might have developed a feature per spec. Make
sure you determine your SME's level of SME.
5) Don't catch your "SME" off-guard. First contact should be
scheduled. It's only polite, as they have work to do, and you know how
much you hate getting interrupted when under deadline. If you both hit
it off and they say to drop in any time, do so, even if just to ask
about their weekend.
6) Ask the "SME" for their opinion, not on what you should document or
write, but how they think the user will like the feature. You may find
the differences between the answers to "how does it work" and "how do
you think they'll like it" astonishing.
Golden rule is that you're all on the same team with the same goal,
and you're all fairly intelligent human beings. Teamwork starts and
ends with relationships. Make yours matter.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon
<> wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 11

13-07-2011 02:57 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The engineer might be interested in your input if you can get involved in the project early enough in the process.
If you want to propose design changes after several test cycles, you have to accept that the engineer
might not be able to address your suggestions until the next version.
------------------------------------------------------------
Ruth Sessions
603/886-7355
________________________________
From: "Cardimon, Craig"
To: 'Kerstin Peterson' <>; "'techwr-'"
Sent: Wednesday, July 13, 2011 9:24 AM
Subject: RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've grown to detest the moniker "SME" as it takes the human
completely out of the equation.
Here are some real tips:
1) The "SME" is a human being who was tasked to deliver a portion of
the overall project, just like you were with the documentation.
2) The "SME" generally has interests outside the project and more
often than not enjoys conversation with other co-workers and project
team members. Try it sometime.
3) Both you and the "SME" have the same interests in mind. Both of you
will put the user first, but in your hearts you know you're excited
about the next paycheck.
4) The "SME" may not be a SME about much of anything. They may know
less about the user than you do. They might be a SME in C# or other
such technology, but might have developed a feature per spec. Make
sure you determine your SME's level of SME.
5) Don't catch your "SME" off-guard. First contact should be
scheduled. It's only polite, as they have work to do, and you know how
much you hate getting interrupted when under deadline. If you both hit
it off and they say to drop in any time, do so, even if just to ask
about their weekend.
6) Ask the "SME" for their opinion, not on what you should document or
write, but how they think the user will like the feature. You may find
the differences between the answers to "how does it work" and "how do
you think they'll like it" astonishing.
Golden rule is that you're all on the same team with the same goal,
and you're all fairly intelligent human beings. Teamwork starts and
ends with relationships. Make yours matter.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon
<> wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 12

13-07-2011 03:01 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The engineer might be interested in your input if you can get involved in the project early enough in the process.
If you want to propose design changes after several test cycles, you have to accept that the engineer
might not be able to address your suggestions until the next version.
------------------------------------------------------------
Ruth Sessions
603/886-7355
________________________________
From: "Cardimon, Craig"
To: 'Kerstin Peterson' <>; "'techwr-'"
Sent: Wednesday, July 13, 2011 9:24 AM
Subject: RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've grown to detest the moniker "SME" as it takes the human
completely out of the equation.
Here are some real tips:
1) The "SME" is a human being who was tasked to deliver a portion of
the overall project, just like you were with the documentation.
2) The "SME" generally has interests outside the project and more
often than not enjoys conversation with other co-workers and project
team members. Try it sometime.
3) Both you and the "SME" have the same interests in mind. Both of you
will put the user first, but in your hearts you know you're excited
about the next paycheck.
4) The "SME" may not be a SME about much of anything. They may know
less about the user than you do. They might be a SME in C# or other
such technology, but might have developed a feature per spec. Make
sure you determine your SME's level of SME.
5) Don't catch your "SME" off-guard. First contact should be
scheduled. It's only polite, as they have work to do, and you know how
much you hate getting interrupted when under deadline. If you both hit
it off and they say to drop in any time, do so, even if just to ask
about their weekend.
6) Ask the "SME" for their opinion, not on what you should document or
write, but how they think the user will like the feature. You may find
the differences between the answers to "how does it work" and "how do
you think they'll like it" astonishing.
Golden rule is that you're all on the same team with the same goal,
and you're all fairly intelligent human beings. Teamwork starts and
ends with relationships. Make yours matter.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon
<> wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
In my experience, all of Bill Swallow's tips were spot on. However, I
feel obliged to defend the Brownie Method. I myself can be easily bribed
with dessert, and so can most of my friends and colleagues.
-----Original Message-----
From: Stephen Arrants
Sent: Wednesday, July 13, 2011 9:57 AM
To: Bill Swallow; Craig Cardimon
Cc: techwr-
Subject: RE: Tips on how to talk to SMEs
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 13

13-07-2011 03:12 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The engineer might be interested in your input if you can get involved in the project early enough in the process.
If you want to propose design changes after several test cycles, you have to accept that the engineer
might not be able to address your suggestions until the next version.
------------------------------------------------------------
Ruth Sessions
603/886-7355
________________________________
From: "Cardimon, Craig"
To: 'Kerstin Peterson' <>; "'techwr-'"
Sent: Wednesday, July 13, 2011 9:24 AM
Subject: RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've grown to detest the moniker "SME" as it takes the human
completely out of the equation.
Here are some real tips:
1) The "SME" is a human being who was tasked to deliver a portion of
the overall project, just like you were with the documentation.
2) The "SME" generally has interests outside the project and more
often than not enjoys conversation with other co-workers and project
team members. Try it sometime.
3) Both you and the "SME" have the same interests in mind. Both of you
will put the user first, but in your hearts you know you're excited
about the next paycheck.
4) The "SME" may not be a SME about much of anything. They may know
less about the user than you do. They might be a SME in C# or other
such technology, but might have developed a feature per spec. Make
sure you determine your SME's level of SME.
5) Don't catch your "SME" off-guard. First contact should be
scheduled. It's only polite, as they have work to do, and you know how
much you hate getting interrupted when under deadline. If you both hit
it off and they say to drop in any time, do so, even if just to ask
about their weekend.
6) Ask the "SME" for their opinion, not on what you should document or
write, but how they think the user will like the feature. You may find
the differences between the answers to "how does it work" and "how do
you think they'll like it" astonishing.
Golden rule is that you're all on the same team with the same goal,
and you're all fairly intelligent human beings. Teamwork starts and
ends with relationships. Make yours matter.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon
<> wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
In my experience, all of Bill Swallow's tips were spot on. However, I
feel obliged to defend the Brownie Method. I myself can be easily bribed
with dessert, and so can most of my friends and colleagues.
-----Original Message-----
From: Stephen Arrants
Sent: Wednesday, July 13, 2011 9:57 AM
To: Bill Swallow; Craig Cardimon
Cc: techwr-
Subject: RE: Tips on how to talk to SMEs
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Don't get me started on bribes... ;)
On Wed, Jul 13, 2011 at 9:57 AM, Stephen Arrants
<> wrote:
> I like Bill Swallow's tips. The original tips were...somewhat
> patronizing and, well, the only thing missing was a tip about brownies.
> But I'm just an old curmudgeon.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 14

13-07-2011 03:13 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The engineer might be interested in your input if you can get involved in the project early enough in the process.
If you want to propose design changes after several test cycles, you have to accept that the engineer
might not be able to address your suggestions until the next version.
------------------------------------------------------------
Ruth Sessions
603/886-7355
________________________________
From: "Cardimon, Craig"
To: 'Kerstin Peterson' <>; "'techwr-'"
Sent: Wednesday, July 13, 2011 9:24 AM
Subject: RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've grown to detest the moniker "SME" as it takes the human
completely out of the equation.
Here are some real tips:
1) The "SME" is a human being who was tasked to deliver a portion of
the overall project, just like you were with the documentation.
2) The "SME" generally has interests outside the project and more
often than not enjoys conversation with other co-workers and project
team members. Try it sometime.
3) Both you and the "SME" have the same interests in mind. Both of you
will put the user first, but in your hearts you know you're excited
about the next paycheck.
4) The "SME" may not be a SME about much of anything. They may know
less about the user than you do. They might be a SME in C# or other
such technology, but might have developed a feature per spec. Make
sure you determine your SME's level of SME.
5) Don't catch your "SME" off-guard. First contact should be
scheduled. It's only polite, as they have work to do, and you know how
much you hate getting interrupted when under deadline. If you both hit
it off and they say to drop in any time, do so, even if just to ask
about their weekend.
6) Ask the "SME" for their opinion, not on what you should document or
write, but how they think the user will like the feature. You may find
the differences between the answers to "how does it work" and "how do
you think they'll like it" astonishing.
Golden rule is that you're all on the same team with the same goal,
and you're all fairly intelligent human beings. Teamwork starts and
ends with relationships. Make yours matter.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon
<> wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
In my experience, all of Bill Swallow's tips were spot on. However, I
feel obliged to defend the Brownie Method. I myself can be easily bribed
with dessert, and so can most of my friends and colleagues.
-----Original Message-----
From: Stephen Arrants
Sent: Wednesday, July 13, 2011 9:57 AM
To: Bill Swallow; Craig Cardimon
Cc: techwr-
Subject: RE: Tips on how to talk to SMEs
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Don't get me started on bribes... ;)
On Wed, Jul 13, 2011 at 9:57 AM, Stephen Arrants
<> wrote:
> I like Bill Swallow's tips. The original tips were...somewhat
> patronizing and, well, the only thing missing was a tip about brownies.
> But I'm just an old curmudgeon.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
When I was working in a CIO's office, I finally got the engineers to the
point where a new IT project was announced, they would tell the PM that they
need to "Get Brian, so he can be involved on the ground floor." My presence
in the meetings acted as a filter between the technical experts and the
Directorate, so that actual communication occured between both groups. It
also meant the IT team didnt have to do any last minute hail mary passes on
project or product documentation.
On Wed, Jul 13, 2011 at 9:48 AM, Ruth Sessions
<>wrote:
> The engineer might be interested in your input if you can get involved in
> the project early enough in the process.
> If you want to propose design changes after several test cycles, you have
> to accept that the engineer
> might not be able to address your suggestions until the next version.
>
> ------------------------------------------------------------
> Ruth Sessions
> 603/886-7355
>
>
> ________________________________
> From: "Cardimon, Craig"
> To: 'Kerstin Peterson' <>; "'
> techwr-'"
> Sent: Wednesday, July 13, 2011 9:24 AM
> Subject: RE: Tips on how to talk to SMEs
>
> It is their baby. We always think our own baby is cute and adorable.
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Kerstin Peterson
> Sent: Wednesday, July 13, 2011 9:14 AM
> To: techwr-
> Subject: Re: Tips on how to talk to SMEs
>
> I think the point here that is not quite being made is that the SME
> (assuming it is the engineer that developed the product, which is sometimes
> not true) feels that the product is easy to understand, because s/he does.
>
>
>
> On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
> >wrote:
>
> > I would also tend to disagree with it. It makes for discussion, though,
> > does it not?
> >
> > -----Original Message-----
> > From: techwr-l-bounces+ccardimon=m-s- [mailto:
> > techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Dan
> > Goldstein
> > Sent: Wednesday, July 13, 2011 9:04 AM
> > To: techwr-
> > Subject: RE: Tips on how to talk to SMEs
> >
> > I respectfully disagree with:
> >
> > "The SME assumes that the project was programmed in a way that everyone
> > should be able to understand it without documentation, since no one
> > looks at it anyway."
> >
> > Those two generalizations about SMEs are often false, and they're also
> > contradictory. I would never project those attitudes onto an SME prior
> > to discussing the work.
> >
> >
> > -----Original Message-----
> > From: Craig Cardimon
> > Sent: Wednesday, July 13, 2011 8:20 AM
> > To: techwr-
> > Subject: Tips on how to talk to SMEs
> >
> > These suggestions might help:
> >
> > http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
> >
> >
> >
> >
> >
> > This message contains confidential information intended only for the use
> of
> > the addressee(s). If you are not the addressee, or the person responsible
> > for delivering it to the addressee, you are hereby notified that reading,
> > disseminating, distributing, copying, electronic storing or the taking of
> > any action in reliance on the contents of this message is strictly
> > prohibited. If you have received this message by mistake, please notify
> us,
> > by replying to the sender, and delete the original message immediately
> > thereafter. Thank you.
> >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> > http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
> >
> *****************************************************************************************************************************************
> > Information contained in this e-mail transmission is privileged and
> > confidential. If you are not the intended recipient of this email,
> > do not read, distribute or reproduce this transmission (including any
> > attachments). If you have received this e-mail in error, please
> > immediately notify the sender by telephone or email reply.
> >
> >
> *****************************************************************************************************************************************
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as .
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> >
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
>
>
> --
> Kerstin Day Peterson
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/bertran.de.st.jean%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
In Service to the Dream,
Brian C. Bertrand
SKA-Bertran de Saint Jean
I am a fan of the cereal comma: Part of a balanced breakfast that includes
milk, juice, and toast.
Showing deference to those with power over you is not courtesy, it is
self-preservation. Showing deference to those over whom you have power is
not only courtesy, but grace.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 15

13-07-2011 03:16 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The engineer might be interested in your input if you can get involved in the project early enough in the process.
If you want to propose design changes after several test cycles, you have to accept that the engineer
might not be able to address your suggestions until the next version.
------------------------------------------------------------
Ruth Sessions
603/886-7355
________________________________
From: "Cardimon, Craig"
To: 'Kerstin Peterson' <>; "'techwr-'"
Sent: Wednesday, July 13, 2011 9:24 AM
Subject: RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've grown to detest the moniker "SME" as it takes the human
completely out of the equation.
Here are some real tips:
1) The "SME" is a human being who was tasked to deliver a portion of
the overall project, just like you were with the documentation.
2) The "SME" generally has interests outside the project and more
often than not enjoys conversation with other co-workers and project
team members. Try it sometime.
3) Both you and the "SME" have the same interests in mind. Both of you
will put the user first, but in your hearts you know you're excited
about the next paycheck.
4) The "SME" may not be a SME about much of anything. They may know
less about the user than you do. They might be a SME in C# or other
such technology, but might have developed a feature per spec. Make
sure you determine your SME's level of SME.
5) Don't catch your "SME" off-guard. First contact should be
scheduled. It's only polite, as they have work to do, and you know how
much you hate getting interrupted when under deadline. If you both hit
it off and they say to drop in any time, do so, even if just to ask
about their weekend.
6) Ask the "SME" for their opinion, not on what you should document or
write, but how they think the user will like the feature. You may find
the differences between the answers to "how does it work" and "how do
you think they'll like it" astonishing.
Golden rule is that you're all on the same team with the same goal,
and you're all fairly intelligent human beings. Teamwork starts and
ends with relationships. Make yours matter.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon
<> wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
In my experience, all of Bill Swallow's tips were spot on. However, I
feel obliged to defend the Brownie Method. I myself can be easily bribed
with dessert, and so can most of my friends and colleagues.
-----Original Message-----
From: Stephen Arrants
Sent: Wednesday, July 13, 2011 9:57 AM
To: Bill Swallow; Craig Cardimon
Cc: techwr-
Subject: RE: Tips on how to talk to SMEs
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Don't get me started on bribes... ;)
On Wed, Jul 13, 2011 at 9:57 AM, Stephen Arrants
<> wrote:
> I like Bill Swallow's tips. The original tips were...somewhat
> patronizing and, well, the only thing missing was a tip about brownies.
> But I'm just an old curmudgeon.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
When I was working in a CIO's office, I finally got the engineers to the
point where a new IT project was announced, they would tell the PM that they
need to "Get Brian, so he can be involved on the ground floor." My presence
in the meetings acted as a filter between the technical experts and the
Directorate, so that actual communication occured between both groups. It
also meant the IT team didnt have to do any last minute hail mary passes on
project or product documentation.
On Wed, Jul 13, 2011 at 9:48 AM, Ruth Sessions
<>wrote:
> The engineer might be interested in your input if you can get involved in
> the project early enough in the process.
> If you want to propose design changes after several test cycles, you have
> to accept that the engineer
> might not be able to address your suggestions until the next version.
>
> ------------------------------------------------------------
> Ruth Sessions
> 603/886-7355
>
>
> ________________________________
> From: "Cardimon, Craig"
> To: 'Kerstin Peterson' <>; "'
> techwr-'"
> Sent: Wednesday, July 13, 2011 9:24 AM
> Subject: RE: Tips on how to talk to SMEs
>
> It is their baby. We always think our own baby is cute and adorable.
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Kerstin Peterson
> Sent: Wednesday, July 13, 2011 9:14 AM
> To: techwr-
> Subject: Re: Tips on how to talk to SMEs
>
> I think the point here that is not quite being made is that the SME
> (assuming it is the engineer that developed the product, which is sometimes
> not true) feels that the product is easy to understand, because s/he does.
>
>
>
> On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
> >wrote:
>
> > I would also tend to disagree with it. It makes for discussion, though,
> > does it not?
> >
> > -----Original Message-----
> > From: techwr-l-bounces+ccardimon=m-s- [mailto:
> > techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Dan
> > Goldstein
> > Sent: Wednesday, July 13, 2011 9:04 AM
> > To: techwr-
> > Subject: RE: Tips on how to talk to SMEs
> >
> > I respectfully disagree with:
> >
> > "The SME assumes that the project was programmed in a way that everyone
> > should be able to understand it without documentation, since no one
> > looks at it anyway."
> >
> > Those two generalizations about SMEs are often false, and they're also
> > contradictory. I would never project those attitudes onto an SME prior
> > to discussing the work.
> >
> >
> > -----Original Message-----
> > From: Craig Cardimon
> > Sent: Wednesday, July 13, 2011 8:20 AM
> > To: techwr-
> > Subject: Tips on how to talk to SMEs
> >
> > These suggestions might help:
> >
> > http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
> >
> >
> >
> >
> >
> > This message contains confidential information intended only for the use
> of
> > the addressee(s). If you are not the addressee, or the person responsible
> > for delivering it to the addressee, you are hereby notified that reading,
> > disseminating, distributing, copying, electronic storing or the taking of
> > any action in reliance on the contents of this message is strictly
> > prohibited. If you have received this message by mistake, please notify
> us,
> > by replying to the sender, and delete the original message immediately
> > thereafter. Thank you.
> >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> > http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
> >
> *****************************************************************************************************************************************
> > Information contained in this e-mail transmission is privileged and
> > confidential. If you are not the intended recipient of this email,
> > do not read, distribute or reproduce this transmission (including any
> > attachments). If you have received this e-mail in error, please
> > immediately notify the sender by telephone or email reply.
> >
> >
> *****************************************************************************************************************************************
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as .
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> >
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
>
>
> --
> Kerstin Day Peterson
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/bertran.de.st.jean%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
In Service to the Dream,
Brian C. Bertrand
SKA-Bertran de Saint Jean
I am a fan of the cereal comma: Part of a balanced breakfast that includes
milk, juice, and toast.
Showing deference to those with power over you is not courtesy, it is
self-preservation. Showing deference to those over whom you have power is
not only courtesy, but grace.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Indeed it does.
From: M.Vina- [mailto:M.Vina-]
Sent: Wednesday, July 13, 2011 9:29 AM
To: Cardimon, Craig
Cc: 'Kerstin Peterson'; 'techwr-'; techwr-l-bounces+m.vina-baltsas=
Subject: RE: Tips on how to talk to SMEs
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and proprietary material for the sole use of the intended recipient. Any review or distribution by others is strictly prohibited. If you are not the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>, "'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 16

13-07-2011 03:21 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The engineer might be interested in your input if you can get involved in the project early enough in the process.
If you want to propose design changes after several test cycles, you have to accept that the engineer
might not be able to address your suggestions until the next version.
------------------------------------------------------------
Ruth Sessions
603/886-7355
________________________________
From: "Cardimon, Craig"
To: 'Kerstin Peterson' <>; "'techwr-'"
Sent: Wednesday, July 13, 2011 9:24 AM
Subject: RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've grown to detest the moniker "SME" as it takes the human
completely out of the equation.
Here are some real tips:
1) The "SME" is a human being who was tasked to deliver a portion of
the overall project, just like you were with the documentation.
2) The "SME" generally has interests outside the project and more
often than not enjoys conversation with other co-workers and project
team members. Try it sometime.
3) Both you and the "SME" have the same interests in mind. Both of you
will put the user first, but in your hearts you know you're excited
about the next paycheck.
4) The "SME" may not be a SME about much of anything. They may know
less about the user than you do. They might be a SME in C# or other
such technology, but might have developed a feature per spec. Make
sure you determine your SME's level of SME.
5) Don't catch your "SME" off-guard. First contact should be
scheduled. It's only polite, as they have work to do, and you know how
much you hate getting interrupted when under deadline. If you both hit
it off and they say to drop in any time, do so, even if just to ask
about their weekend.
6) Ask the "SME" for their opinion, not on what you should document or
write, but how they think the user will like the feature. You may find
the differences between the answers to "how does it work" and "how do
you think they'll like it" astonishing.
Golden rule is that you're all on the same team with the same goal,
and you're all fairly intelligent human beings. Teamwork starts and
ends with relationships. Make yours matter.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon
<> wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
In my experience, all of Bill Swallow's tips were spot on. However, I
feel obliged to defend the Brownie Method. I myself can be easily bribed
with dessert, and so can most of my friends and colleagues.
-----Original Message-----
From: Stephen Arrants
Sent: Wednesday, July 13, 2011 9:57 AM
To: Bill Swallow; Craig Cardimon
Cc: techwr-
Subject: RE: Tips on how to talk to SMEs
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Don't get me started on bribes... ;)
On Wed, Jul 13, 2011 at 9:57 AM, Stephen Arrants
<> wrote:
> I like Bill Swallow's tips. The original tips were...somewhat
> patronizing and, well, the only thing missing was a tip about brownies.
> But I'm just an old curmudgeon.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
When I was working in a CIO's office, I finally got the engineers to the
point where a new IT project was announced, they would tell the PM that they
need to "Get Brian, so he can be involved on the ground floor." My presence
in the meetings acted as a filter between the technical experts and the
Directorate, so that actual communication occured between both groups. It
also meant the IT team didnt have to do any last minute hail mary passes on
project or product documentation.
On Wed, Jul 13, 2011 at 9:48 AM, Ruth Sessions
<>wrote:
> The engineer might be interested in your input if you can get involved in
> the project early enough in the process.
> If you want to propose design changes after several test cycles, you have
> to accept that the engineer
> might not be able to address your suggestions until the next version.
>
> ------------------------------------------------------------
> Ruth Sessions
> 603/886-7355
>
>
> ________________________________
> From: "Cardimon, Craig"
> To: 'Kerstin Peterson' <>; "'
> techwr-'"
> Sent: Wednesday, July 13, 2011 9:24 AM
> Subject: RE: Tips on how to talk to SMEs
>
> It is their baby. We always think our own baby is cute and adorable.
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Kerstin Peterson
> Sent: Wednesday, July 13, 2011 9:14 AM
> To: techwr-
> Subject: Re: Tips on how to talk to SMEs
>
> I think the point here that is not quite being made is that the SME
> (assuming it is the engineer that developed the product, which is sometimes
> not true) feels that the product is easy to understand, because s/he does.
>
>
>
> On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
> >wrote:
>
> > I would also tend to disagree with it. It makes for discussion, though,
> > does it not?
> >
> > -----Original Message-----
> > From: techwr-l-bounces+ccardimon=m-s- [mailto:
> > techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Dan
> > Goldstein
> > Sent: Wednesday, July 13, 2011 9:04 AM
> > To: techwr-
> > Subject: RE: Tips on how to talk to SMEs
> >
> > I respectfully disagree with:
> >
> > "The SME assumes that the project was programmed in a way that everyone
> > should be able to understand it without documentation, since no one
> > looks at it anyway."
> >
> > Those two generalizations about SMEs are often false, and they're also
> > contradictory. I would never project those attitudes onto an SME prior
> > to discussing the work.
> >
> >
> > -----Original Message-----
> > From: Craig Cardimon
> > Sent: Wednesday, July 13, 2011 8:20 AM
> > To: techwr-
> > Subject: Tips on how to talk to SMEs
> >
> > These suggestions might help:
> >
> > http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
> >
> >
> >
> >
> >
> > This message contains confidential information intended only for the use
> of
> > the addressee(s). If you are not the addressee, or the person responsible
> > for delivering it to the addressee, you are hereby notified that reading,
> > disseminating, distributing, copying, electronic storing or the taking of
> > any action in reliance on the contents of this message is strictly
> > prohibited. If you have received this message by mistake, please notify
> us,
> > by replying to the sender, and delete the original message immediately
> > thereafter. Thank you.
> >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> > http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
> >
> *****************************************************************************************************************************************
> > Information contained in this e-mail transmission is privileged and
> > confidential. If you are not the intended recipient of this email,
> > do not read, distribute or reproduce this transmission (including any
> > attachments). If you have received this e-mail in error, please
> > immediately notify the sender by telephone or email reply.
> >
> >
> *****************************************************************************************************************************************
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as .
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> >
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
>
>
> --
> Kerstin Day Peterson
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/bertran.de.st.jean%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
In Service to the Dream,
Brian C. Bertrand
SKA-Bertran de Saint Jean
I am a fan of the cereal comma: Part of a balanced breakfast that includes
milk, juice, and toast.
Showing deference to those with power over you is not courtesy, it is
self-preservation. Showing deference to those over whom you have power is
not only courtesy, but grace.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Indeed it does.
From: M.Vina- [mailto:M.Vina-]
Sent: Wednesday, July 13, 2011 9:29 AM
To: Cardimon, Craig
Cc: 'Kerstin Peterson'; 'techwr-'; techwr-l-bounces+m.vina-baltsas=
Subject: RE: Tips on how to talk to SMEs
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and proprietary material for the sole use of the intended recipient. Any review or distribution by others is strictly prohibited. If you are not the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>, "'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've never used bribes to get work done. Ever. I have certainly
brought in goodies - whether homemade pastries or even homebrew - but
never in a working context. I don't recommend it. I've actually seen
and heard something very similar to the following, and just shook my
head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
On Wed, Jul 13, 2011 at 10:01 AM, Dan Goldstein
<> wrote:
> In my experience, all of Bill Swallow's tips were spot on. However, I
> feel obliged to defend the Brownie Method. I myself can be easily bribed
> with dessert, and so can most of my friends and colleagues.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 17

13-07-2011 03:22 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The engineer might be interested in your input if you can get involved in the project early enough in the process.
If you want to propose design changes after several test cycles, you have to accept that the engineer
might not be able to address your suggestions until the next version.
------------------------------------------------------------
Ruth Sessions
603/886-7355
________________________________
From: "Cardimon, Craig"
To: 'Kerstin Peterson' <>; "'techwr-'"
Sent: Wednesday, July 13, 2011 9:24 AM
Subject: RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've grown to detest the moniker "SME" as it takes the human
completely out of the equation.
Here are some real tips:
1) The "SME" is a human being who was tasked to deliver a portion of
the overall project, just like you were with the documentation.
2) The "SME" generally has interests outside the project and more
often than not enjoys conversation with other co-workers and project
team members. Try it sometime.
3) Both you and the "SME" have the same interests in mind. Both of you
will put the user first, but in your hearts you know you're excited
about the next paycheck.
4) The "SME" may not be a SME about much of anything. They may know
less about the user than you do. They might be a SME in C# or other
such technology, but might have developed a feature per spec. Make
sure you determine your SME's level of SME.
5) Don't catch your "SME" off-guard. First contact should be
scheduled. It's only polite, as they have work to do, and you know how
much you hate getting interrupted when under deadline. If you both hit
it off and they say to drop in any time, do so, even if just to ask
about their weekend.
6) Ask the "SME" for their opinion, not on what you should document or
write, but how they think the user will like the feature. You may find
the differences between the answers to "how does it work" and "how do
you think they'll like it" astonishing.
Golden rule is that you're all on the same team with the same goal,
and you're all fairly intelligent human beings. Teamwork starts and
ends with relationships. Make yours matter.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon
<> wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
In my experience, all of Bill Swallow's tips were spot on. However, I
feel obliged to defend the Brownie Method. I myself can be easily bribed
with dessert, and so can most of my friends and colleagues.
-----Original Message-----
From: Stephen Arrants
Sent: Wednesday, July 13, 2011 9:57 AM
To: Bill Swallow; Craig Cardimon
Cc: techwr-
Subject: RE: Tips on how to talk to SMEs
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Don't get me started on bribes... ;)
On Wed, Jul 13, 2011 at 9:57 AM, Stephen Arrants
<> wrote:
> I like Bill Swallow's tips. The original tips were...somewhat
> patronizing and, well, the only thing missing was a tip about brownies.
> But I'm just an old curmudgeon.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
When I was working in a CIO's office, I finally got the engineers to the
point where a new IT project was announced, they would tell the PM that they
need to "Get Brian, so he can be involved on the ground floor." My presence
in the meetings acted as a filter between the technical experts and the
Directorate, so that actual communication occured between both groups. It
also meant the IT team didnt have to do any last minute hail mary passes on
project or product documentation.
On Wed, Jul 13, 2011 at 9:48 AM, Ruth Sessions
<>wrote:
> The engineer might be interested in your input if you can get involved in
> the project early enough in the process.
> If you want to propose design changes after several test cycles, you have
> to accept that the engineer
> might not be able to address your suggestions until the next version.
>
> ------------------------------------------------------------
> Ruth Sessions
> 603/886-7355
>
>
> ________________________________
> From: "Cardimon, Craig"
> To: 'Kerstin Peterson' <>; "'
> techwr-'"
> Sent: Wednesday, July 13, 2011 9:24 AM
> Subject: RE: Tips on how to talk to SMEs
>
> It is their baby. We always think our own baby is cute and adorable.
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Kerstin Peterson
> Sent: Wednesday, July 13, 2011 9:14 AM
> To: techwr-
> Subject: Re: Tips on how to talk to SMEs
>
> I think the point here that is not quite being made is that the SME
> (assuming it is the engineer that developed the product, which is sometimes
> not true) feels that the product is easy to understand, because s/he does.
>
>
>
> On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
> >wrote:
>
> > I would also tend to disagree with it. It makes for discussion, though,
> > does it not?
> >
> > -----Original Message-----
> > From: techwr-l-bounces+ccardimon=m-s- [mailto:
> > techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Dan
> > Goldstein
> > Sent: Wednesday, July 13, 2011 9:04 AM
> > To: techwr-
> > Subject: RE: Tips on how to talk to SMEs
> >
> > I respectfully disagree with:
> >
> > "The SME assumes that the project was programmed in a way that everyone
> > should be able to understand it without documentation, since no one
> > looks at it anyway."
> >
> > Those two generalizations about SMEs are often false, and they're also
> > contradictory. I would never project those attitudes onto an SME prior
> > to discussing the work.
> >
> >
> > -----Original Message-----
> > From: Craig Cardimon
> > Sent: Wednesday, July 13, 2011 8:20 AM
> > To: techwr-
> > Subject: Tips on how to talk to SMEs
> >
> > These suggestions might help:
> >
> > http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
> >
> >
> >
> >
> >
> > This message contains confidential information intended only for the use
> of
> > the addressee(s). If you are not the addressee, or the person responsible
> > for delivering it to the addressee, you are hereby notified that reading,
> > disseminating, distributing, copying, electronic storing or the taking of
> > any action in reliance on the contents of this message is strictly
> > prohibited. If you have received this message by mistake, please notify
> us,
> > by replying to the sender, and delete the original message immediately
> > thereafter. Thank you.
> >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> > http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
> >
> *****************************************************************************************************************************************
> > Information contained in this e-mail transmission is privileged and
> > confidential. If you are not the intended recipient of this email,
> > do not read, distribute or reproduce this transmission (including any
> > attachments). If you have received this e-mail in error, please
> > immediately notify the sender by telephone or email reply.
> >
> >
> *****************************************************************************************************************************************
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as .
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> >
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
>
>
> --
> Kerstin Day Peterson
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/bertran.de.st.jean%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
In Service to the Dream,
Brian C. Bertrand
SKA-Bertran de Saint Jean
I am a fan of the cereal comma: Part of a balanced breakfast that includes
milk, juice, and toast.
Showing deference to those with power over you is not courtesy, it is
self-preservation. Showing deference to those over whom you have power is
not only courtesy, but grace.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Indeed it does.
From: M.Vina- [mailto:M.Vina-]
Sent: Wednesday, July 13, 2011 9:29 AM
To: Cardimon, Craig
Cc: 'Kerstin Peterson'; 'techwr-'; techwr-l-bounces+m.vina-baltsas=
Subject: RE: Tips on how to talk to SMEs
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and proprietary material for the sole use of the intended recipient. Any review or distribution by others is strictly prohibited. If you are not the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>, "'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've never used bribes to get work done. Ever. I have certainly
brought in goodies - whether homemade pastries or even homebrew - but
never in a working context. I don't recommend it. I've actually seen
and heard something very similar to the following, and just shook my
head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
On Wed, Jul 13, 2011 at 10:01 AM, Dan Goldstein
<> wrote:
> In my experience, all of Bill Swallow's tips were spot on. However, I
> feel obliged to defend the Brownie Method. I myself can be easily bribed
> with dessert, and so can most of my friends and colleagues.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I'm defending the brownie method. Also snacks and candy. You can still use cigarettes for bartering at my place.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Bill Swallow
Sent: Wednesday, July 13, 2011 10:21 AM
To: Dan Goldstein
Cc: techwr-
Subject: Re: Tips on how to talk to SMEs
I've never used bribes to get work done. Ever. I have certainly
brought in goodies - whether homemade pastries or even homebrew - but
never in a working context. I don't recommend it. I've actually seen
and heard something very similar to the following, and just shook my
head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
On Wed, Jul 13, 2011 at 10:01 AM, Dan Goldstein
<> wrote:
> In my experience, all of Bill Swallow's tips were spot on. However, I
> feel obliged to defend the Brownie Method. I myself can be easily bribed
> with dessert, and so can most of my friends and colleagues.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 18

13-07-2011 03:34 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The engineer might be interested in your input if you can get involved in the project early enough in the process.
If you want to propose design changes after several test cycles, you have to accept that the engineer
might not be able to address your suggestions until the next version.
------------------------------------------------------------
Ruth Sessions
603/886-7355
________________________________
From: "Cardimon, Craig"
To: 'Kerstin Peterson' <>; "'techwr-'"
Sent: Wednesday, July 13, 2011 9:24 AM
Subject: RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've grown to detest the moniker "SME" as it takes the human
completely out of the equation.
Here are some real tips:
1) The "SME" is a human being who was tasked to deliver a portion of
the overall project, just like you were with the documentation.
2) The "SME" generally has interests outside the project and more
often than not enjoys conversation with other co-workers and project
team members. Try it sometime.
3) Both you and the "SME" have the same interests in mind. Both of you
will put the user first, but in your hearts you know you're excited
about the next paycheck.
4) The "SME" may not be a SME about much of anything. They may know
less about the user than you do. They might be a SME in C# or other
such technology, but might have developed a feature per spec. Make
sure you determine your SME's level of SME.
5) Don't catch your "SME" off-guard. First contact should be
scheduled. It's only polite, as they have work to do, and you know how
much you hate getting interrupted when under deadline. If you both hit
it off and they say to drop in any time, do so, even if just to ask
about their weekend.
6) Ask the "SME" for their opinion, not on what you should document or
write, but how they think the user will like the feature. You may find
the differences between the answers to "how does it work" and "how do
you think they'll like it" astonishing.
Golden rule is that you're all on the same team with the same goal,
and you're all fairly intelligent human beings. Teamwork starts and
ends with relationships. Make yours matter.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon
<> wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
In my experience, all of Bill Swallow's tips were spot on. However, I
feel obliged to defend the Brownie Method. I myself can be easily bribed
with dessert, and so can most of my friends and colleagues.
-----Original Message-----
From: Stephen Arrants
Sent: Wednesday, July 13, 2011 9:57 AM
To: Bill Swallow; Craig Cardimon
Cc: techwr-
Subject: RE: Tips on how to talk to SMEs
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Don't get me started on bribes... ;)
On Wed, Jul 13, 2011 at 9:57 AM, Stephen Arrants
<> wrote:
> I like Bill Swallow's tips. The original tips were...somewhat
> patronizing and, well, the only thing missing was a tip about brownies.
> But I'm just an old curmudgeon.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
When I was working in a CIO's office, I finally got the engineers to the
point where a new IT project was announced, they would tell the PM that they
need to "Get Brian, so he can be involved on the ground floor." My presence
in the meetings acted as a filter between the technical experts and the
Directorate, so that actual communication occured between both groups. It
also meant the IT team didnt have to do any last minute hail mary passes on
project or product documentation.
On Wed, Jul 13, 2011 at 9:48 AM, Ruth Sessions
<>wrote:
> The engineer might be interested in your input if you can get involved in
> the project early enough in the process.
> If you want to propose design changes after several test cycles, you have
> to accept that the engineer
> might not be able to address your suggestions until the next version.
>
> ------------------------------------------------------------
> Ruth Sessions
> 603/886-7355
>
>
> ________________________________
> From: "Cardimon, Craig"
> To: 'Kerstin Peterson' <>; "'
> techwr-'"
> Sent: Wednesday, July 13, 2011 9:24 AM
> Subject: RE: Tips on how to talk to SMEs
>
> It is their baby. We always think our own baby is cute and adorable.
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Kerstin Peterson
> Sent: Wednesday, July 13, 2011 9:14 AM
> To: techwr-
> Subject: Re: Tips on how to talk to SMEs
>
> I think the point here that is not quite being made is that the SME
> (assuming it is the engineer that developed the product, which is sometimes
> not true) feels that the product is easy to understand, because s/he does.
>
>
>
> On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
> >wrote:
>
> > I would also tend to disagree with it. It makes for discussion, though,
> > does it not?
> >
> > -----Original Message-----
> > From: techwr-l-bounces+ccardimon=m-s- [mailto:
> > techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Dan
> > Goldstein
> > Sent: Wednesday, July 13, 2011 9:04 AM
> > To: techwr-
> > Subject: RE: Tips on how to talk to SMEs
> >
> > I respectfully disagree with:
> >
> > "The SME assumes that the project was programmed in a way that everyone
> > should be able to understand it without documentation, since no one
> > looks at it anyway."
> >
> > Those two generalizations about SMEs are often false, and they're also
> > contradictory. I would never project those attitudes onto an SME prior
> > to discussing the work.
> >
> >
> > -----Original Message-----
> > From: Craig Cardimon
> > Sent: Wednesday, July 13, 2011 8:20 AM
> > To: techwr-
> > Subject: Tips on how to talk to SMEs
> >
> > These suggestions might help:
> >
> > http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
> >
> >
> >
> >
> >
> > This message contains confidential information intended only for the use
> of
> > the addressee(s). If you are not the addressee, or the person responsible
> > for delivering it to the addressee, you are hereby notified that reading,
> > disseminating, distributing, copying, electronic storing or the taking of
> > any action in reliance on the contents of this message is strictly
> > prohibited. If you have received this message by mistake, please notify
> us,
> > by replying to the sender, and delete the original message immediately
> > thereafter. Thank you.
> >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> > http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
> >
> *****************************************************************************************************************************************
> > Information contained in this e-mail transmission is privileged and
> > confidential. If you are not the intended recipient of this email,
> > do not read, distribute or reproduce this transmission (including any
> > attachments). If you have received this e-mail in error, please
> > immediately notify the sender by telephone or email reply.
> >
> >
> *****************************************************************************************************************************************
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as .
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> >
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
>
>
> --
> Kerstin Day Peterson
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/bertran.de.st.jean%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
In Service to the Dream,
Brian C. Bertrand
SKA-Bertran de Saint Jean
I am a fan of the cereal comma: Part of a balanced breakfast that includes
milk, juice, and toast.
Showing deference to those with power over you is not courtesy, it is
self-preservation. Showing deference to those over whom you have power is
not only courtesy, but grace.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Indeed it does.
From: M.Vina- [mailto:M.Vina-]
Sent: Wednesday, July 13, 2011 9:29 AM
To: Cardimon, Craig
Cc: 'Kerstin Peterson'; 'techwr-'; techwr-l-bounces+m.vina-baltsas=
Subject: RE: Tips on how to talk to SMEs
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and proprietary material for the sole use of the intended recipient. Any review or distribution by others is strictly prohibited. If you are not the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>, "'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've never used bribes to get work done. Ever. I have certainly
brought in goodies - whether homemade pastries or even homebrew - but
never in a working context. I don't recommend it. I've actually seen
and heard something very similar to the following, and just shook my
head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
On Wed, Jul 13, 2011 at 10:01 AM, Dan Goldstein
<> wrote:
> In my experience, all of Bill Swallow's tips were spot on. However, I
> feel obliged to defend the Brownie Method. I myself can be easily bribed
> with dessert, and so can most of my friends and colleagues.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I'm defending the brownie method. Also snacks and candy. You can still use cigarettes for bartering at my place.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Bill Swallow
Sent: Wednesday, July 13, 2011 10:21 AM
To: Dan Goldstein
Cc: techwr-
Subject: Re: Tips on how to talk to SMEs
I've never used bribes to get work done. Ever. I have certainly
brought in goodies - whether homemade pastries or even homebrew - but
never in a working context. I don't recommend it. I've actually seen
and heard something very similar to the following, and just shook my
head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
On Wed, Jul 13, 2011 at 10:01 AM, Dan Goldstein
<> wrote:
> In my experience, all of Bill Swallow's tips were spot on. However, I
> feel obliged to defend the Brownie Method. I myself can be easily bribed
> with dessert, and so can most of my friends and colleagues.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I apologize for jokingly using the word "bribe," and even "barter" is
too strong.
Let me put it this way: Walking in with a plate of cookies is no
different from walking in with a smile and a handshake.
-----Original Message-----
From: Cardimon, Craig
Sent: Wednesday, July 13, 2011 10:22 AM
To: 'Bill Swallow'; Dan Goldstein
Cc: 'techwr-'
Subject: RE: Tips on how to talk to SMEs
I'm defending the brownie method. Also snacks and candy. You can still
use cigarettes for bartering at my place.
-----Original Message-----
From: Bill Swallow
Sent: Wednesday, July 13, 2011 10:21 AM
To: Dan Goldstein
Cc: techwr-
Subject: Re: Tips on how to talk to SMEs
I've never used bribes to get work done. Ever. I have certainly brought
in goodies - whether homemade pastries or even homebrew - but never in a
working context. I don't recommend it. I've actually seen and heard
something very similar to the following, and just shook my head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 19

13-07-2011 03:36 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The engineer might be interested in your input if you can get involved in the project early enough in the process.
If you want to propose design changes after several test cycles, you have to accept that the engineer
might not be able to address your suggestions until the next version.
------------------------------------------------------------
Ruth Sessions
603/886-7355
________________________________
From: "Cardimon, Craig"
To: 'Kerstin Peterson' <>; "'techwr-'"
Sent: Wednesday, July 13, 2011 9:24 AM
Subject: RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've grown to detest the moniker "SME" as it takes the human
completely out of the equation.
Here are some real tips:
1) The "SME" is a human being who was tasked to deliver a portion of
the overall project, just like you were with the documentation.
2) The "SME" generally has interests outside the project and more
often than not enjoys conversation with other co-workers and project
team members. Try it sometime.
3) Both you and the "SME" have the same interests in mind. Both of you
will put the user first, but in your hearts you know you're excited
about the next paycheck.
4) The "SME" may not be a SME about much of anything. They may know
less about the user than you do. They might be a SME in C# or other
such technology, but might have developed a feature per spec. Make
sure you determine your SME's level of SME.
5) Don't catch your "SME" off-guard. First contact should be
scheduled. It's only polite, as they have work to do, and you know how
much you hate getting interrupted when under deadline. If you both hit
it off and they say to drop in any time, do so, even if just to ask
about their weekend.
6) Ask the "SME" for their opinion, not on what you should document or
write, but how they think the user will like the feature. You may find
the differences between the answers to "how does it work" and "how do
you think they'll like it" astonishing.
Golden rule is that you're all on the same team with the same goal,
and you're all fairly intelligent human beings. Teamwork starts and
ends with relationships. Make yours matter.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon
<> wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
In my experience, all of Bill Swallow's tips were spot on. However, I
feel obliged to defend the Brownie Method. I myself can be easily bribed
with dessert, and so can most of my friends and colleagues.
-----Original Message-----
From: Stephen Arrants
Sent: Wednesday, July 13, 2011 9:57 AM
To: Bill Swallow; Craig Cardimon
Cc: techwr-
Subject: RE: Tips on how to talk to SMEs
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Don't get me started on bribes... ;)
On Wed, Jul 13, 2011 at 9:57 AM, Stephen Arrants
<> wrote:
> I like Bill Swallow's tips. The original tips were...somewhat
> patronizing and, well, the only thing missing was a tip about brownies.
> But I'm just an old curmudgeon.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
When I was working in a CIO's office, I finally got the engineers to the
point where a new IT project was announced, they would tell the PM that they
need to "Get Brian, so he can be involved on the ground floor." My presence
in the meetings acted as a filter between the technical experts and the
Directorate, so that actual communication occured between both groups. It
also meant the IT team didnt have to do any last minute hail mary passes on
project or product documentation.
On Wed, Jul 13, 2011 at 9:48 AM, Ruth Sessions
<>wrote:
> The engineer might be interested in your input if you can get involved in
> the project early enough in the process.
> If you want to propose design changes after several test cycles, you have
> to accept that the engineer
> might not be able to address your suggestions until the next version.
>
> ------------------------------------------------------------
> Ruth Sessions
> 603/886-7355
>
>
> ________________________________
> From: "Cardimon, Craig"
> To: 'Kerstin Peterson' <>; "'
> techwr-'"
> Sent: Wednesday, July 13, 2011 9:24 AM
> Subject: RE: Tips on how to talk to SMEs
>
> It is their baby. We always think our own baby is cute and adorable.
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Kerstin Peterson
> Sent: Wednesday, July 13, 2011 9:14 AM
> To: techwr-
> Subject: Re: Tips on how to talk to SMEs
>
> I think the point here that is not quite being made is that the SME
> (assuming it is the engineer that developed the product, which is sometimes
> not true) feels that the product is easy to understand, because s/he does.
>
>
>
> On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
> >wrote:
>
> > I would also tend to disagree with it. It makes for discussion, though,
> > does it not?
> >
> > -----Original Message-----
> > From: techwr-l-bounces+ccardimon=m-s- [mailto:
> > techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Dan
> > Goldstein
> > Sent: Wednesday, July 13, 2011 9:04 AM
> > To: techwr-
> > Subject: RE: Tips on how to talk to SMEs
> >
> > I respectfully disagree with:
> >
> > "The SME assumes that the project was programmed in a way that everyone
> > should be able to understand it without documentation, since no one
> > looks at it anyway."
> >
> > Those two generalizations about SMEs are often false, and they're also
> > contradictory. I would never project those attitudes onto an SME prior
> > to discussing the work.
> >
> >
> > -----Original Message-----
> > From: Craig Cardimon
> > Sent: Wednesday, July 13, 2011 8:20 AM
> > To: techwr-
> > Subject: Tips on how to talk to SMEs
> >
> > These suggestions might help:
> >
> > http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
> >
> >
> >
> >
> >
> > This message contains confidential information intended only for the use
> of
> > the addressee(s). If you are not the addressee, or the person responsible
> > for delivering it to the addressee, you are hereby notified that reading,
> > disseminating, distributing, copying, electronic storing or the taking of
> > any action in reliance on the contents of this message is strictly
> > prohibited. If you have received this message by mistake, please notify
> us,
> > by replying to the sender, and delete the original message immediately
> > thereafter. Thank you.
> >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> > http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
> >
> *****************************************************************************************************************************************
> > Information contained in this e-mail transmission is privileged and
> > confidential. If you are not the intended recipient of this email,
> > do not read, distribute or reproduce this transmission (including any
> > attachments). If you have received this e-mail in error, please
> > immediately notify the sender by telephone or email reply.
> >
> >
> *****************************************************************************************************************************************
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as .
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> >
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
>
>
> --
> Kerstin Day Peterson
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/bertran.de.st.jean%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
In Service to the Dream,
Brian C. Bertrand
SKA-Bertran de Saint Jean
I am a fan of the cereal comma: Part of a balanced breakfast that includes
milk, juice, and toast.
Showing deference to those with power over you is not courtesy, it is
self-preservation. Showing deference to those over whom you have power is
not only courtesy, but grace.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Indeed it does.
From: M.Vina- [mailto:M.Vina-]
Sent: Wednesday, July 13, 2011 9:29 AM
To: Cardimon, Craig
Cc: 'Kerstin Peterson'; 'techwr-'; techwr-l-bounces+m.vina-baltsas=
Subject: RE: Tips on how to talk to SMEs
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and proprietary material for the sole use of the intended recipient. Any review or distribution by others is strictly prohibited. If you are not the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>, "'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've never used bribes to get work done. Ever. I have certainly
brought in goodies - whether homemade pastries or even homebrew - but
never in a working context. I don't recommend it. I've actually seen
and heard something very similar to the following, and just shook my
head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
On Wed, Jul 13, 2011 at 10:01 AM, Dan Goldstein
<> wrote:
> In my experience, all of Bill Swallow's tips were spot on. However, I
> feel obliged to defend the Brownie Method. I myself can be easily bribed
> with dessert, and so can most of my friends and colleagues.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I'm defending the brownie method. Also snacks and candy. You can still use cigarettes for bartering at my place.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Bill Swallow
Sent: Wednesday, July 13, 2011 10:21 AM
To: Dan Goldstein
Cc: techwr-
Subject: Re: Tips on how to talk to SMEs
I've never used bribes to get work done. Ever. I have certainly
brought in goodies - whether homemade pastries or even homebrew - but
never in a working context. I don't recommend it. I've actually seen
and heard something very similar to the following, and just shook my
head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
On Wed, Jul 13, 2011 at 10:01 AM, Dan Goldstein
<> wrote:
> In my experience, all of Bill Swallow's tips were spot on. However, I
> feel obliged to defend the Brownie Method. I myself can be easily bribed
> with dessert, and so can most of my friends and colleagues.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I apologize for jokingly using the word "bribe," and even "barter" is
too strong.
Let me put it this way: Walking in with a plate of cookies is no
different from walking in with a smile and a handshake.
-----Original Message-----
From: Cardimon, Craig
Sent: Wednesday, July 13, 2011 10:22 AM
To: 'Bill Swallow'; Dan Goldstein
Cc: 'techwr-'
Subject: RE: Tips on how to talk to SMEs
I'm defending the brownie method. Also snacks and candy. You can still
use cigarettes for bartering at my place.
-----Original Message-----
From: Bill Swallow
Sent: Wednesday, July 13, 2011 10:21 AM
To: Dan Goldstein
Cc: techwr-
Subject: Re: Tips on how to talk to SMEs
I've never used bribes to get work done. Ever. I have certainly brought
in goodies - whether homemade pastries or even homebrew - but never in a
working context. I don't recommend it. I've actually seen and heard
something very similar to the following, and just shook my head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Bribery can work as an atmosphere-setter, depending on the SMEs and the project culture. When I had to create an API where the SMEs were a bunch of programmers half my age, I bought a fifty-dollar box of random goodies from Archie McPhee.
I gave the first guy who helped me his pick from the box, and it was something really nice. I asked him to write an email describing his prize. After that I had guys running to answer my questions. Even when the toys ran out they were in the habit of answering.
They could have easily bought their own toys, so it was all a charade. But it worked. It helped that I only bothered them after finding out as much as possible on my own, and that I went to some of their happy hours.
Treat the SMEs like humans, show them that you're human, and they tend to act like humans to you.
Or maybe I was just lucky.
- Jessica
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
# 20

13-07-2011 03:36 PM
|
|
|
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Craig Cardimon
"The Duct Tape Writer"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would also tend to disagree with it. It makes for discussion, though, does it not?
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 9:04 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I respectfully disagree with:
"The SME assumes that the project was programmed in a way that everyone
should be able to understand it without documentation, since no one
looks at it anyway."
Those two generalizations about SMEs are often false, and they're also
contradictory. I would never project those attitudes onto an SME prior
to discussing the work.
-----Original Message-----
From: Craig Cardimon
Sent: Wednesday, July 13, 2011 8:20 AM
To: techwr-
Subject: Tips on how to talk to SMEs
These suggestions might help:
http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I would agree. I ask lots of questions everywhere else before I knock on an SME's door.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:10 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
The most important thing about approaching SMEs, in my opinion, is to have
exhausted all other avenues for answers to your questions before you take up
their valuable time. SMEs think that tech writers ask dumb questions in the
first place (which we do, from their viewpoint), and asking a question that
makes it obvious that you haven't done your homework proves them right.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon <>wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
> --
> Craig Cardimon
> "The Duct Tape Writer"
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
proprietary material for the sole use of the intended recipient. Any
review or distribution by others is strictly prohibited. If you are not
the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>,
"'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s-
[mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf
Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is
sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use
of
> the addressee(s). If you are not the addressee, or the person
responsible
> for delivering it to the addressee, you are hereby notified that
reading,
> disseminating, distributing, copying, electronic storing or the taking
of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify
us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
*****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
>
*****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and
confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any
attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with
Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
The engineer might be interested in your input if you can get involved in the project early enough in the process.
If you want to propose design changes after several test cycles, you have to accept that the engineer
might not be able to address your suggestions until the next version.
------------------------------------------------------------
Ruth Sessions
603/886-7355
________________________________
From: "Cardimon, Craig"
To: 'Kerstin Peterson' <>; "'techwr-'"
Sent: Wednesday, July 13, 2011 9:24 AM
Subject: RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've grown to detest the moniker "SME" as it takes the human
completely out of the equation.
Here are some real tips:
1) The "SME" is a human being who was tasked to deliver a portion of
the overall project, just like you were with the documentation.
2) The "SME" generally has interests outside the project and more
often than not enjoys conversation with other co-workers and project
team members. Try it sometime.
3) Both you and the "SME" have the same interests in mind. Both of you
will put the user first, but in your hearts you know you're excited
about the next paycheck.
4) The "SME" may not be a SME about much of anything. They may know
less about the user than you do. They might be a SME in C# or other
such technology, but might have developed a feature per spec. Make
sure you determine your SME's level of SME.
5) Don't catch your "SME" off-guard. First contact should be
scheduled. It's only polite, as they have work to do, and you know how
much you hate getting interrupted when under deadline. If you both hit
it off and they say to drop in any time, do so, even if just to ask
about their weekend.
6) Ask the "SME" for their opinion, not on what you should document or
write, but how they think the user will like the feature. You may find
the differences between the answers to "how does it work" and "how do
you think they'll like it" astonishing.
Golden rule is that you're all on the same team with the same goal,
and you're all fairly intelligent human beings. Teamwork starts and
ends with relationships. Make yours matter.
On Wed, Jul 13, 2011 at 8:19 AM, Craig Cardimon
<> wrote:
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
In my experience, all of Bill Swallow's tips were spot on. However, I
feel obliged to defend the Brownie Method. I myself can be easily bribed
with dessert, and so can most of my friends and colleagues.
-----Original Message-----
From: Stephen Arrants
Sent: Wednesday, July 13, 2011 9:57 AM
To: Bill Swallow; Craig Cardimon
Cc: techwr-
Subject: RE: Tips on how to talk to SMEs
I like Bill Swallow's tips. The original tips were...somewhat
patronizing and, well, the only thing missing was a tip about brownies.
But I'm just an old curmudgeon.
Bill Swallow says:
> Subject: Re: Tips on how to talk to SMEs
>
> I've grown to detest the moniker "SME" as it takes the human
completely
> out of the equation.
>
> Here are some real tips:
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Don't get me started on bribes... ;)
On Wed, Jul 13, 2011 at 9:57 AM, Stephen Arrants
<> wrote:
> I like Bill Swallow's tips. The original tips were...somewhat
> patronizing and, well, the only thing missing was a tip about brownies.
> But I'm just an old curmudgeon.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
When I was working in a CIO's office, I finally got the engineers to the
point where a new IT project was announced, they would tell the PM that they
need to "Get Brian, so he can be involved on the ground floor." My presence
in the meetings acted as a filter between the technical experts and the
Directorate, so that actual communication occured between both groups. It
also meant the IT team didnt have to do any last minute hail mary passes on
project or product documentation.
On Wed, Jul 13, 2011 at 9:48 AM, Ruth Sessions
<>wrote:
> The engineer might be interested in your input if you can get involved in
> the project early enough in the process.
> If you want to propose design changes after several test cycles, you have
> to accept that the engineer
> might not be able to address your suggestions until the next version.
>
> ------------------------------------------------------------
> Ruth Sessions
> 603/886-7355
>
>
> ________________________________
> From: "Cardimon, Craig"
> To: 'Kerstin Peterson' <>; "'
> techwr-'"
> Sent: Wednesday, July 13, 2011 9:24 AM
> Subject: RE: Tips on how to talk to SMEs
>
> It is their baby. We always think our own baby is cute and adorable.
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Kerstin Peterson
> Sent: Wednesday, July 13, 2011 9:14 AM
> To: techwr-
> Subject: Re: Tips on how to talk to SMEs
>
> I think the point here that is not quite being made is that the SME
> (assuming it is the engineer that developed the product, which is sometimes
> not true) feels that the product is easy to understand, because s/he does.
>
>
>
> On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig
> >wrote:
>
> > I would also tend to disagree with it. It makes for discussion, though,
> > does it not?
> >
> > -----Original Message-----
> > From: techwr-l-bounces+ccardimon=m-s- [mailto:
> > techwr-l-bounces+ccardimon=m-s-] On Behalf Of
> Dan
> > Goldstein
> > Sent: Wednesday, July 13, 2011 9:04 AM
> > To: techwr-
> > Subject: RE: Tips on how to talk to SMEs
> >
> > I respectfully disagree with:
> >
> > "The SME assumes that the project was programmed in a way that everyone
> > should be able to understand it without documentation, since no one
> > looks at it anyway."
> >
> > Those two generalizations about SMEs are often false, and they're also
> > contradictory. I would never project those attitudes onto an SME prior
> > to discussing the work.
> >
> >
> > -----Original Message-----
> > From: Craig Cardimon
> > Sent: Wednesday, July 13, 2011 8:20 AM
> > To: techwr-
> > Subject: Tips on how to talk to SMEs
> >
> > These suggestions might help:
> >
> > http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
> >
> >
> >
> >
> >
> > This message contains confidential information intended only for the use
> of
> > the addressee(s). If you are not the addressee, or the person responsible
> > for delivering it to the addressee, you are hereby notified that reading,
> > disseminating, distributing, copying, electronic storing or the taking of
> > any action in reliance on the contents of this message is strictly
> > prohibited. If you have received this message by mistake, please notify
> us,
> > by replying to the sender, and delete the original message immediately
> > thereafter. Thank you.
> >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> > http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
> >
> *****************************************************************************************************************************************
> > Information contained in this e-mail transmission is privileged and
> > confidential. If you are not the intended recipient of this email,
> > do not read, distribute or reproduce this transmission (including any
> > attachments). If you have received this e-mail in error, please
> > immediately notify the sender by telephone or email reply.
> >
> >
> *****************************************************************************************************************************************
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > Create and publish documentation through multiple channels with
> > Doc-To-Help.
> > Choose your authoring formats and get any output you may need. Try
> > Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> > http://www.doctohelp.com
> >
> > ---
> > You are currently subscribed to TECHWR-L as .
> >
> > To unsubscribe send a blank email to
> > techwr-l-
> > or visit
> >
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
> >
> >
> > To subscribe, send a blank email to techwr-l-
> >
> > Send administrative questions to . Visit
> > http://www.techwr-l.com/ for more resources and info.
> >
> > Please move off-topic discussions to the Chat list, at:
> > http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> >
> >
>
>
> --
> Kerstin Day Peterson
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/bertran.de.st.jean%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
In Service to the Dream,
Brian C. Bertrand
SKA-Bertran de Saint Jean
I am a fan of the cereal comma: Part of a balanced breakfast that includes
milk, juice, and toast.
Showing deference to those with power over you is not courtesy, it is
self-preservation. Showing deference to those over whom you have power is
not only courtesy, but grace.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Indeed it does.
From: M.Vina- [mailto:M.Vina-]
Sent: Wednesday, July 13, 2011 9:29 AM
To: Cardimon, Craig
Cc: 'Kerstin Peterson'; 'techwr-'; techwr-l-bounces+m.vina-baltsas=
Subject: RE: Tips on how to talk to SMEs
Yes, but they the baby grows up and ships. That's when the fun begins. ;-)
________________________________________________________________
Michelle Viņa-Baltsas
Senior Technical Writer
Tel: 201-995-8350
m.vina-
STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and proprietary material for the sole use of the intended recipient. Any review or distribution by others is strictly prohibited. If you are not the intended recipient please contact the sender and delete all copies.
"Cardimon, Craig"
Sent by: techwr-l-bounces+m.vina-baltsas=
07/13/2011 09:26 AM
To
'Kerstin Peterson' <>, "'techwr-'"
cc
Subject
RE: Tips on how to talk to SMEs
It is their baby. We always think our own baby is cute and adorable.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Kerstin Peterson
Sent: Wednesday, July 13, 2011 9:14 AM
To: techwr-
Subject: Re: Tips on how to talk to SMEs
I think the point here that is not quite being made is that the SME
(assuming it is the engineer that developed the product, which is sometimes
not true) feels that the product is easy to understand, because s/he does.
On Wed, Jul 13, 2011 at 9:08 AM, Cardimon, Craig wrote:
> I would also tend to disagree with it. It makes for discussion, though,
> does it not?
>
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s- [mailto:
> techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan
> Goldstein
> Sent: Wednesday, July 13, 2011 9:04 AM
> To: techwr-
> Subject: RE: Tips on how to talk to SMEs
>
> I respectfully disagree with:
>
> "The SME assumes that the project was programmed in a way that everyone
> should be able to understand it without documentation, since no one
> looks at it anyway."
>
> Those two generalizations about SMEs are often false, and they're also
> contradictory. I would never project those attitudes onto an SME prior
> to discussing the work.
>
>
> -----Original Message-----
> From: Craig Cardimon
> Sent: Wednesday, July 13, 2011 8:20 AM
> To: techwr-
> Subject: Tips on how to talk to SMEs
>
> These suggestions might help:
>
> http://morespecifically.wordpress.com/2011/07/13/play-nice-with-an-sme/
>
>
>
>
>
> This message contains confidential information intended only for the use of
> the addressee(s). If you are not the addressee, or the person responsible
> for delivering it to the addressee, you are hereby notified that reading,
> disseminating, distributing, copying, electronic storing or the taking of
> any action in reliance on the contents of this message is strictly
> prohibited. If you have received this message by mistake, please notify us,
> by replying to the sender, and delete the original message immediately
> thereafter. Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
> *****************************************************************************************************************************************
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email,
> do not read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please
> immediately notify the sender by telephone or email reply.
>
> *****************************************************************************************************************************************
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as .
>
> To unsubscribe send a blank email to
> techwr-l-
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/kerstin.peterson%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-
>
> Send administrative questions to . Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Kerstin Day Peterson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as M.Vina-.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/m.vina-baltsas%40mindray.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I've never used bribes to get work done. Ever. I have certainly
brought in goodies - whether homemade pastries or even homebrew - but
never in a working context. I don't recommend it. I've actually seen
and heard something very similar to the following, and just shook my
head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
On Wed, Jul 13, 2011 at 10:01 AM, Dan Goldstein
<> wrote:
> In my experience, all of Bill Swallow's tips were spot on. However, I
> feel obliged to defend the Brownie Method. I myself can be easily bribed
> with dessert, and so can most of my friends and colleagues.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I'm defending the brownie method. Also snacks and candy. You can still use cigarettes for bartering at my place.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Bill Swallow
Sent: Wednesday, July 13, 2011 10:21 AM
To: Dan Goldstein
Cc: techwr-
Subject: Re: Tips on how to talk to SMEs
I've never used bribes to get work done. Ever. I have certainly
brought in goodies - whether homemade pastries or even homebrew - but
never in a working context. I don't recommend it. I've actually seen
and heard something very similar to the following, and just shook my
head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
On Wed, Jul 13, 2011 at 10:01 AM, Dan Goldstein
<> wrote:
> In my experience, all of Bill Swallow's tips were spot on. However, I
> feel obliged to defend the Brownie Method. I myself can be easily bribed
> with dessert, and so can most of my friends and colleagues.
--
Bill Swallow
Twitter: @techcommdood
Blog: http://techcommdood.com
LinkedIn: http://www.linkedin.com/in/techcommdood
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
I apologize for jokingly using the word "bribe," and even "barter" is
too strong.
Let me put it this way: Walking in with a plate of cookies is no
different from walking in with a smile and a handshake.
-----Original Message-----
From: Cardimon, Craig
Sent: Wednesday, July 13, 2011 10:22 AM
To: 'Bill Swallow'; Dan Goldstein
Cc: 'techwr-'
Subject: RE: Tips on how to talk to SMEs
I'm defending the brownie method. Also snacks and candy. You can still
use cigarettes for bartering at my place.
-----Original Message-----
From: Bill Swallow
Sent: Wednesday, July 13, 2011 10:21 AM
To: Dan Goldstein
Cc: techwr-
Subject: Re: Tips on how to talk to SMEs
I've never used bribes to get work done. Ever. I have certainly brought
in goodies - whether homemade pastries or even homebrew - but never in a
working context. I don't recommend it. I've actually seen and heard
something very similar to the following, and just shook my head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Bribery can work as an atmosphere-setter, depending on the SMEs and the project culture. When I had to create an API where the SMEs were a bunch of programmers half my age, I bought a fifty-dollar box of random goodies from Archie McPhee.
I gave the first guy who helped me his pick from the box, and it was something really nice. I asked him to write an email describing his prize. After that I had guys running to answer my questions. Even when the toys ran out they were in the habit of answering.
They could have easily bought their own toys, so it was all a charade. But it worked. It helped that I only bothered them after finding out as much as possible on my own, and that I went to some of their happy hours.
Treat the SMEs like humans, show them that you're human, and they tend to act like humans to you.
Or maybe I was just lucky.
- Jessica
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
Sure. We're not talking real "go to jail" bribery here.
-----Original Message-----
From: techwr-l-bounces+ccardimon=m-s- [mailto:techwr-l-bounces+ccardimon=m-s-] On Behalf Of Dan Goldstein
Sent: Wednesday, July 13, 2011 10:35 AM
To: techwr-
Subject: RE: Tips on how to talk to SMEs
I apologize for jokingly using the word "bribe," and even "barter" is
too strong.
Let me put it this way: Walking in with a plate of cookies is no
different from walking in with a smile and a handshake.
-----Original Message-----
From: Cardimon, Craig
Sent: Wednesday, July 13, 2011 10:22 AM
To: 'Bill Swallow'; Dan Goldstein
Cc: 'techwr-'
Subject: RE: Tips on how to talk to SMEs
I'm defending the brownie method. Also snacks and candy. You can still
use cigarettes for bartering at my place.
-----Original Message-----
From: Bill Swallow
Sent: Wednesday, July 13, 2011 10:21 AM
To: Dan Goldstein
Cc: techwr-
Subject: Re: Tips on how to talk to SMEs
I've never used bribes to get work done. Ever. I have certainly brought
in goodies - whether homemade pastries or even homebrew - but never in a
working context. I don't recommend it. I've actually seen and heard
something very similar to the following, and just shook my head.
Writer: "I really need to get 5 minutes of your time."
SME: "What, no cookies?" (turns away)
It's an extreme example, but it happens. You're all there to do a job.
Just get it done. You're all humans, so engage them. Keep the
festivities and goodies as non-project-related surprises, not because
you need something from them, but because you just felt like sharing.
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as ccardimon@m-s-g.com.
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ccardimon%40m-s-g.com
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
*****************************************************************************************************************************************
Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email,
do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please
immediately notify the sender by telephone or email reply.
*****************************************************************************************************************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as .
To unsubscribe send a blank email to
techwr-l-
or visit http://lists.techwr-l.com/mailman/options/techwr-l/rebbecca.emm%40zeusmail.org
To subscribe, send a blank email to techwr-l-
Send administrative questions to . Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
)
|
NewsArc Lists
| Culture Pages
| Computing Archive
| Media-Pages
Link to this page on your blog or website by copying the HTML code below and pasting it into your site:
|
|