[Framers] What causes documentation to fail

[john.x.posada at us.hsbc.com]

I don't have control of the agenda.

John X Posada
SR AML Syst & Ops Supt Data Analyst | Global Risk Analytics | HSBC North
America Holdings Inc
330 Madison Ave., NY NY
                                                                    
 __________________________________________________________________ 
                                                                    
                                                                    
                                                                    
                                                                    
                                                                    
 Phone                                                              
      Int: 212-525-5483 Ext: 646-735-1857                           
 Fax                                                                
      Conference Bridge - 877-304-0052, Code 74809254               
 Email                                                              
      john.x.posada at us.hsbc.com                                     
                                                                    
 __________________________________________________________________ 
 Protect our environment - please only print this if you have to!   
                                                                    





From:	"Etzel, Gary" <gary.etzel at dnvgl.com>
To:	John X Posada/HBUS/HSBC at HSBC02, "framers at lists.frameusers.com"
            <framers at lists.frameusers.com>
Date:	05/20/2016 02:16 PM
Subject:	RE: [Framers] What causes documentation to fail



I think you should pose the question as "What causes documentation to
succeed?" Present the issue in a positive light, not a negative one. For
example:

- Employing trained, dedicated technical communicators.
- Involving technical documentation from the first day of the project.
- Clearly defining roles, responsibilities, and scope.

And so on.

Gary


-----Original Message-----
From: Framers [mailto:framers-bounces
+gary.etzel=dnvgl.com at lists.frameusers.com] On Behalf Of
john.x.posada at us.hsbc.com
Sent: Friday, May 20, 2016 12:49 PM
To: framers at lists.frameusers.com
Subject: [Framers] What causes documentation to fail


Hi, guys...by end of today, I need to present to my manager a few bullet
points for a presentation she is doing on Monday.

The subject is: "What Causes Documentation to Fail"

I've started with a few points:

   Not writing to a well-understood target audience
   Including too little or too much information
   Failure to bring documentation into the project early enough in the
   project
   Failure to establish a governance, review, and approval structure
   Lack of clear  roles and responsibilities
   Belief that “anyone can produce acceptable documentation”
   Lack of feedback early enough in the process to implement without
   wasting a large amount of work and/or affecting deadline
   Scope creep

Anyone want to add more to the list?


John X Posada
SR AML Syst & Ops Supt Data Analyst | Global Risk Analytics | HSBC North
America Holdings Inc
330 Madison Ave., NY NY

 __________________________________________________________________





 Phone
      Int: 212-525-5483 Ext: 646-735-1857
 Fax
      Conference Bridge - 877-304-0052, Code 74809254
 Email
      john.x.posada at us.hsbc.com

 __________________________________________________________________
 Protect our environment - please only print this if you have to!



-----------------------------------------
******************************************************************
This E-mail is confidential. It may also be legally privileged. If you are
not the addressee you may not copy, forward, disclose or use any part of
it. If you have received this message in error, please delete it and all
copies from your system and notify the sender immediately by return E-mail.

Internet communications cannot be guaranteed to be timely, secure, error or
virus-free. The sender does not accept liability for any errors or
omissions.
******************************************************************
SAVE PAPER - THINK BEFORE YOU PRINT!
_______________________________________________

This message is from the Framers mailing list

Send messages to framers at lists.frameusers.com Visit the list's homepage at
http://www.frameusers.com Archives located at
http://www.mail-archive.com/framers%40lists.frameusers.com/
Subscribe and unsubscribe at
http://lists.frameusers.com/listinfo.cgi/framers-frameusers.com
Send administrative questions to listadmin at frameusers.com

**************************************************************************************

This e-mail and any attachments thereto may contain confidential
information and/or information protected by intellectual property rights
for the exclusive attention of the intended addressees named above. If you
have received this transmission in error, please immediately notify the
sender by return e-mail and delete this message and its attachments.
Unauthorized use, copying or further full or partial distribution of this
e-mail or its contents is prohibited.
**************************************************************************************



******************************************************************
This message originated from the Internet. Its originator may or may not be
who they claim to be and the information contained in the message and any
attachments may or may not be accurate.
******************************************************************


-----------------------------------------
******************************************************************
This E-mail is confidential. It may also be legally privileged. If
you are not the addressee you may not copy, forward, disclose or
use any part of it. If you have received this message in error,
please delete it and all copies from your system and notify the
sender immediately by return E-mail.

Internet communications cannot be guaranteed to be timely, secure,
error or virus-free. The sender does not accept liability for any
errors or omissions.
******************************************************************
SAVE PAPER - THINK BEFORE YOU PRINT!