WTHashtag Logo

#tcchat

wthashtag.com/tcchat

Transcript from February 16, 2011 to February 16, 2011

All times are Pacific Time
 
February 16, 2011
1:11 pm hletutour: RT @2moroDocs: Auj à 18h sur #tcchat il sera question de guides de styles. Rejoignez-nous pr partager votre expertise & apprendre! #techcomm
1:14 pm hletutour: RT @2moroDocs: Comment faire pour suivre le #tcchat et participer ? Toutes les infos : http://bit.ly/ejmOxZ #techcomm
3:10 pm content2000: looking for a good way to label a series of user-generated content when linking from a corp. site. thoughts? #techcomm #tcchat
3:30 pm TC_Chat: #tcchat in an hour & a half (9amPT). Topic: style guides. Corp > doc team > project. In S2, effect of mobile, UGC on style guides #techcomm
3:30 pm 2moroDocs: #tcchat in an hour & a half (9amPT). Topic: style guides. Corp > doc team > project. In S2, effect of mobile, UGC on style guides
3:31 pm 2moroDocs: @lrmeyer747 Thx for the RT about #tcchat -
3:32 pm 2moroDocs: @hletutour Merci beaucoup pour le RT - #tcchat
3:34 pm 2moroDocs: Chicago Manual of Style http://bit.ly/19gvqQ #tcchat
3:35 pm content2000: @2moroDocs ooo... I won't be around for S2 but looks like my UGC question might be answered then...will scan transcript tmrw... #tcchat
3:36 pm 2moroDocs: AP Style Guide http://www.apstylebook.com/ #tcchat
3:40 pm 2moroDocs: If anyone knows of other online editing refs (in addition to Chicago & AP) could u please tweet them for #tcchat?
3:41 pm 2moroDocs: Speaking of AP guide, I know they officially switched to website (1 word). I'm 4 dropping hyphen in email. Maybe discuss if time? #tcchat
3:45 pm 2moroDocs: More Chicago refs: FB http://on.fb.me/eInVX6 . Twitter http://twitter.com/ChicagoManual . #tcchat
3:56 pm lrmeyer747: RT @2moroDocs: More Chicago refs: FB http://on.fb.me/eInVX6 . Twitter http://twitter.com/ChicagoManual . #tcchat
4:09 pm content2000: @annegentle doing it manually too but using social media mining tools to find UCG. What do you call your UCG when you post it? #tcchat
4:22 pm juliov27612: RT @2moroDocs: Chicago Manual of Style http://bit.ly/19gvqQ #tcchat
4:22 pm juliov27612: RT @2moroDocs: AP Style Guide http://www.apstylebook.com/ #tcchat
4:25 pm 2moroDocs: Just letting you know - there's a possibility that we may have some TW students sit in on a #tcchat from time to time, which would be nice.
4:26 pm vcsujith: RT @2moroDocs: #tcchat in an hour & a half (9amPT). Topic: style guides. Corp > doc team > project. In S2, effect of mobile, UGC on style guides
4:34 pm 2moroDocs: Blog post for students coming momentarily... #tcchat
4:41 pm 2moroDocs: New post: To Students Participating in #tcchat: Some Ideas http://bit.ly/gCf2od
5:00 pm 2moroDocs: Hello everyone! Welcome to today?s S1 of #tcchat. The topic is style guides, which is a requested topic.
5:01 pm 2moroDocs: Reminders: Add #tcchat to your tweets. Avoid using #techcomm tag as it will overwhelm that tag. Thx! Also, no proprietary info!
5:01 pm ricksapir: @2moroDocs LOTS of editing resources http://bit.ly/hYnMld #tcchat #techcomm
5:01 pm 2moroDocs: I will post main questions/discussion points using @TC_Chat. Then you can open that feed & easily see current questions #tcchat
5:02 pm 2moroDocs: Main topics: Down through hierarchy: corp > doc team > project. Also naming conv 4 UGC docs #tcchat
5:02 pm 2moroDocs: @ricksapir Thx Rick! #tcchat
5:02 pm 2moroDocs: Ques came in this morning re some UGC wording, hence last item. Will work it in #tcchat
5:03 pm 2moroDocs: S2 topics: details re use of mobile, UGC, etc on style guides #tcchat
5:03 pm 2moroDocs: Whew! At the wire this morning. Here we go. Who's here? #tcchat
5:04 pm 2moroDocs: Will jump in w/first ques #tcchat
5:05 pm TC_Chat: Q1: What style considerations are there at the corporate level? Ex: corp comm., legal, ???#tcchat
5:05 pm hletutour: Hi there! I'm here! #tcchat
5:06 pm 2moroDocs: @hletutour Hi Helene! #tcchat
5:07 pm 2moroDocs: A1: I think that at the corporate level, you have Corp Comm requirements and potential legal issues #tcchat
5:08 pm 2moroDocs: Speaking of legal, that's something TWs always need to keep in mind, IMO. #tcchat
5:08 pm 2moroDocs: Corp comm = branding, I think #tcchat
5:08 pm ricksapir: A1. Brand identity and consistency, too #tcchat
5:09 pm 2moroDocs: @ricksapir We sent that at the same time. #tcchat
5:10 pm content2000: @TC_Chat A1 corp has branding requirements, trademark issues (legal) etc - affects boilerplate text for sure, as well as logo etc #tcchat
5:10 pm 2moroDocs: A1: branding: correct use of company name, terms, logos, registered trademarks - that sort of thing #tcchat
5:10 pm 2moroDocs: Also, whether or not company name is abbreviated or not #tcchat
5:11 pm ricksapir: A1. At corp level, time to market (speed) is VERY important, too. #tcchat
5:12 pm 2moroDocs: Looks like we're all thinking the same thing. Company reqs at the highest level, def trickle down to docs #tcchat
5:12 pm 2moroDocs: Will jump to Q2: the meat of the disc #tcchat
5:13 pm TC_Chat: Q2: What style considerations at doc team level? Focus on formatting, caps, ??? #tcchat
5:14 pm 2moroDocs: @ricksapir Good point. Speed very impt, esp in this real-time world #tcchat
5:14 pm hletutour: A2: format considerations = use of bold, italic, colors maybe #tcchat
5:15 pm kemulholland: @TC_Chat #tcchat Establish style guide & templates, make ppl use them, kick noncompliant items back to authors, move on.
5:16 pm content2000: A2 consistant voice #tcchat
5:16 pm 2moroDocs: @kemulholland Good point. Style guide must be followed #tcchat
5:17 pm content2000: @kemulholland ooo yes...governance over implementing consistant style... very important #tcchat
5:17 pm CharJTF: You can include terms in your style guide, too. (Helpful with ESL writers.) #tcchat
5:18 pm 2moroDocs: Who has final say on enforcing SG if no editor on team? #tcchat
5:18 pm kemulholland: @2moroDocs #tcchat "Consistent voice" is overrated. Agree w/@CharJTF - include a terms list in style guide. Voice will take care of itself.
5:18 pm content2000: Also...common example items (IP addresses etc) that apply to docs. #tcchat
5:19 pm 2moroDocs: @charjtf Agreed. Terminology very impt #tcchat
5:19 pm kemulholland: @2moroDocs #tcchat One person needs to be designated to enforce style guide & template usage, other pre-publication checks.
5:19 pm hletutour: @2moroDocs Good question. Particularly in a very small team... I'm asking too! #tcchat
5:19 pm content2000: @kemulholland ooo. disgree on voice :-) Active/passive? big clash. Formal/informal? etc. At high level, it needs tobe consistent #tcchat
5:20 pm ricksapir: A2. Use automagic tools to fix common issues (ref http://bit.ly/fsF7xn ) Don't rely on authors to comply #tcchat
5:20 pm 2moroDocs: Terms list becomes very impt in regulatory docs. Have written safety manuals in past. Capitalization, wording, titles very impt #tcchat
5:20 pm 2moroDocs: Anyone have tips for regulatory, legal, medical SG reqs? #tcchat
5:22 pm content2000: @kemulholland ok we're in agreement then. That was my definition of consistent voice :-) Peace reigns in #tcchat again
5:23 pm 2moroDocs: Other items for SG: structure. Ex: "Click," not "click on." table setups, "select for drop-down menus (or whatever) #tcchat
5:24 pm CharJTF: #tcchat Note that passive voice is sometimes OK, depending on subject. Concentrate more on sentences making sense.
5:24 pm techcommdood: @kemulholland @2moroDocs Chiming in late.. exactly. Style guide needs an owner/enforcer/champion. Who that is depends on your org. #tcchat
5:25 pm 2moroDocs: Recap for SG content: formatting (bold, etc), caps, color, terms, consistency, active/passive, formal/informal, terms, structure #tcchat
5:26 pm kemulholland: @CharJTF Agree!! #tcchat Focus on getting information to reader effectively, don't fuss about stuff only a writer cares about. Get it done.
5:26 pm content2000: @techcommdood Yes... someone needs to regularly keep writers thinking/implementing that SG #tcchat
5:27 pm CharJTF: #tcchat Style Guide I created for current client says nothing about active/passive or formal/informal. It does provide terms and phrases.
5:27 pm 2moroDocs: Good info, everyone. Think this will help those new to creating a SG #tcchat
5:27 pm hletutour: Do you include phraseology in your style guides? maybe that's what you called "structure", @2moroDocs ? #TCchat
5:27 pm GlobalScript: @kemulholland @2moroDocs Chiming in late.. exactly. Style guide needs an owner/enforcer/champion. Who that is depends on your org. #tcchat
5:27 pm helpstuff: #tcchat now taking place. Today's subject is "style guides". Join in if you can!
5:28 pm 2moroDocs: Yes RT @hletutour: Do you include phraseology in your style guides? maybe that's what you called "structure", @2moroDocs ? #TCchat
5:28 pm 2moroDocs: Believe me, SG discussions are often a hot topic in meetings. What writer doesn't like discussing such items? #tcchat
5:29 pm 2moroDocs: jumping into the project SG info... #tcchat
5:29 pm CharJTF: @hletutour Phraseology, yes, but structure is determined by heading usage. (Also, I use headings for TOC and cross-references.) #TCchat
5:30 pm TC_Chat: Q3: What style considerations are there for specific projects? #tcchat
5:30 pm content2000: @CharJTF yes, that's what I was trying to get at exactly on structure #TCchat
5:30 pm ricksapir: SG becomes more important as content provides contribute specific pieces instead of complete deliverables #tcchat
5:31 pm 2moroDocs: Remember, I have to watch the clock and sometimes move things along. Not trying to cut off any disc. You can keep going on any topic #tcchat
5:32 pm content2000: @ricksapir Yes! xml/topic based chunks reused across docs makes it more important to follow that consistent style #tcchat
5:32 pm techcommdood: @content2000 You mean *using*... owner of the SG needs to be the one maintaining. One owner, not many. Many can suggest. #tcchat
5:34 pm 2moroDocs: Owner of the SG also applies to owner of the doc templates. Whoever creates those incorp decisions made for SG. #tcchat
5:35 pm content2000: project style-guides-again, focused terminology/feature names, structure/outline. Can get more specific than the company-wide SG #tcchat
5:35 pm 2moroDocs: So, some SG reqs built right into templates. (con't) #tcchat
5:35 pm techcommdood: @2moroDocs I hate style "discussions" in meetings, unless meeting for that purpose. Lots of pretense/opinion/noise; peacock parade. #tcchat
5:36 pm 2moroDocs: Ex: you can create "blank" pgs/topics that have proc steps, etc that writers can use, cut & paste, delete, etc. Built right in #tcchat
5:36 pm content2000: @techcommdood good point. SG discussions can get nit-picky. Need to balance customer needs (what's important to them, not to us) #tcchat
5:36 pm CharJTF: #tcchat You can build all sorts of info into template. Just make sure people use it to create doc (not assign it after).
5:37 pm 2moroDocs: @techcommdood Good point. Also, good to determine a schedule. For ex: disc (if necessary) only every 6 mos or so #tcchat
5:37 pm techcommdood: @2moroDocs Or use structured environment where it's all built in w/o adding cut/paste errors and preferential sidestepping. #tcchat
5:37 pm GlobalScript: @2moroDocs Or use structured environment where it's all built in w/o adding cut/paste errors and preferential sidestepping. #tcchat
5:37 pm kemulholland: @techcommdood Agree. Good to schedule style guide discussions monthly, to formalize how the SG is kept current. #tcchat
5:38 pm content2000: another biggie - SG needs to reflect medium customers view info in. Web diff. from print, diff. from mobile access #tcchat
5:38 pm 2moroDocs: One thing is for sure: you can't tinker too much with SGs once made. Too much work to chg templates, user confusion, etc. Also maint #tcchat
5:38 pm 2moroDocs: Maintenance always a major consideration #tcchat
5:40 pm 2moroDocs: @content2000 Agreed. The more generic, the better #tcchat
5:40 pm kemulholland: @2moroDocs #tcchat at MumbleCo we had scheduled SG discussions often, template updates to match corporate branding updates. Worked well.
5:40 pm kmdk: @2morodocs Joining #tcchat a bit late. As lone writer (with 1 temp contractor), I get dictator rights on SG. :D
5:41 pm 2moroDocs: @kemulholland Makes me think: wonder how many SG revisions might be needed due to real-time & UGC items #tcchat
5:42 pm 2moroDocs: These days, do you think TWs need to stay in closer contact w/Corp Comm & legal - & mktg for that matter #tcchat
5:42 pm kmdk: #tcchat Current situation. No SG. Wild West for years. I'm creating/maintaining/managing SG for all re (new) doc templates.
5:43 pm kemulholland: @2moroDocs If SG is a "living doc" & doc team meets 2 discuss monthly, "how many revisions" isn't a worry. #tcchat
5:43 pm cherimullins: Style guides, templates, and models are separate, although templates and models must follow style guide. #tcchat
5:43 pm CharJTF: @2moroDocs Corp Comm should know to stay in touch with TCs. Burden should be on them, not TCs. #tcchat
5:43 pm kmdk: #tcchat When on your own, it's actually an extra challenge to stay structured & not tweak constantly ("only takes a sec").
5:44 pm 2moroDocs: Back to project reqs: think those are mainly terminology requirements #tcchat & what @content2000 said
5:44 pm tc_pete: RT @cherimullins: Style guides, templates, and models are separate, although templates and models must follow style guide. #tcchat
5:44 pm CharJTF: @2moroDocs Diff projects may require additional styles in templates. #tcchat
5:45 pm kemulholland: @CharJTF #tcchat in my experience it never works that way. We live in a world of IS, not SHOULD - so we need to stay visible 2 corp comm.
5:45 pm 2moroDocs: @charjtf Good point. Maybe talk to them up front, tell them what u need to know re changes or whatever. Leave it to them #tcchat
5:46 pm CharJTF: @kemulholland May not work that way, but *should*. Silly for you to add more tasks to find out info you *might* need to know. #tcchat
5:47 pm kemulholland: @CharJTF Very true, & still a problem I haven't solved satisfactorily. #tcchat
5:47 pm 2moroDocs: There's so much going on these days, & real-time a big issue IMO. Everyone (all depts) need 2 be aware of what each dept needs. #tcchat
5:47 pm 2moroDocs: I'd even suggest scheduling monthly meetings with diff depts to see what everyone's dealing with #tcchat
5:49 pm 2moroDocs: Other depts need to know that what they consider a "small" chg that "won't take long" to implement could b HUGE for docs 2 implement #tcchat
5:49 pm techcommdood: You tinker prior to style approval. RT @2moroDocs: One thing is for sure: you can't tinker too much with SGs once made. #tcchat
5:49 pm kmdk: @cherimullins Agree. I document SG info happily. Helps to explain today's decisions tomorrow. #tcchat
5:49 pm 2moroDocs: Yikes! Quick - @content2000 has a ques. Here goes - #tcchat
5:50 pm cherimullins: It works well to implement a sort of "cascading" style guides & templates to accommodate different uses. #tcchat
5:50 pm cherimullins: RT @CharJTF: Diff projects may require additional styles in templates. #tcchat
5:50 pm TC_Chat: Q4: How do you handle style conventions for UGC refs on corp site so customers know it's UGC content & not corp? #tcchat
5:51 pm 2moroDocs: @content2000 If I worded that ques incorrectly, please clarify! #tcchat
5:51 pm techcommdood: Um, ALWAYS. It's not a new need. RT @2moroDocs: These days, do you think TWs need to stay in closer contact w/Corp Comm/legal/mktg #tcchat
5:51 pm GlobalScript: Um, ALWAYS. It's not a new need. RT @2moroDocs: These days, do you think TWs need to stay in closer contact w/Corp Comm/legal/mktg #tcchat
5:51 pm kmdk: @2morodocs 1 of my tasks is to show/prove SG can benefit us all. Show & tell. Strengthens techcomm role in team. #tcchat
5:52 pm techcommdood: #fail RT @kemulholland: @2moroDocs If SG is a "living doc" & doc team meets 2 discuss monthly, "how many revisions" isn't a worry. #tcchat
5:52 pm techcommdood: Disagree. Co-burden. RT @CharJTF: @2moroDocs Corp Comm should know to stay in touch with TCs. Burden should be on them, not TCs. #tcchat
5:53 pm 2moroDocs: For project reqs, I always think of those safety manuals. OSHA has strict terminology. *Extremely* impt to get titles/wording right. #tcchat
5:53 pm kemulholland: @techcommdood #tcchat Would love to discuss at length
5:53 pm CharJTF: @techcommdood If Corp Comm changes branding, it should be on them to inform all who use that branding. TCers shouldn't find out... #tcchat
5:53 pm CharJTF: @techcommdood ...by reading blog or newsletter. #tcchat
5:54 pm 2moroDocs: Safety manual ex: terms, titles impt for emergency planning, etc. Think of emer response between agencies. Have 2 use correct terms #tcchat
5:54 pm kmdk: #tcchat Agree with @techcommdood: Co-burden between TC & Corp Comm. Must be clear open lines of communication between them. Always.
5:54 pm kemulholland: @techcommdood (erk, fatfingers) - because your POV is always well-considered & if we disagree I can usually learn something from u. #tcchat
5:55 pm 2moroDocs: Maybe something like Sarbannes-Oxley has similar reqs. Regulatory situations like that may require strict adherance to SG, esp terms #tcchat
5:55 pm CharJTF: #tcchat I'm not saying there shouldn't be lines of communication. I'm saying that line should go in both directions, not always TC > CC.
5:55 pm kmdk: @2morodocs Last job in regulated industry. I made basic SG to start them off. They were grateful. Too harried to do previously. #tcchat
5:55 pm techcommdood: They shouldn't do that in a vacuum. Period. RT @CharJTF: If Corp Comm changes branding, it should be on them to inform ... #tcchat
5:56 pm 2moroDocs: In other words, sometimes style requirements are bigger than you, bigger than your company. Have to follow some things #tcchat
5:56 pm kmdk: @2morodocs Regulated place *did* have terminology db. & strict approval routines. Crucial for regulation & translation (22 lang.) #tcchat
5:57 pm techcommdood: @kemulholland My POV is that if your style guide is ever-changing, you can never use it as intended - consistency. #tcchat
5:57 pm edmarsh: bwahahahaha. ahahahaha! / /RT @techcommdood: They shouldn't do that in a vacuum. Period. #tcchat
5:57 pm 2moroDocs: Yikes! 3 mins left. Any other thoughts - esp for @content2000's ques? #tcchat
5:58 pm 2moroDocs: Corp Comm can't change branding quickly much these days. Too much going on in the world w/social media #tcchat
5:58 pm techcommdood: Of course it happens, but it's beyond bad. RT @edmarsh: bwahaha... / /RT @techcommdood: They shouldn't do that in a vacuum. Period. #tcchat
5:59 pm 2moroDocs: @edmarsh LOL! #tcchat (or is it lowercase? my son says "lol, mom" and rolls his eyes. Another style thought: texting abbreviations #tcchat
5:59 pm edmarsh: @techcommdood agreed, but that assumes techcommers have that kind of input #tcchat
6:00 pm cherimullins: Onus is on all. Change communication s/b institutionalized. Re: #tcchat Burden on [Corp Comm to communicate changes], not TCs.
6:01 pm techcommdood: @edmarsh This is why I am in the business of doing what I do (and I do it well). :-) #tcchat
6:02 pm 2moroDocs: The hour is up. Already! This was fast today. I had trouble keeping up #tcchat Will have 2 check later to see what I missed
6:02 pm edmarsh: #tcchat we have a standards committee, not sure when it meets, who's on it, what it does. i believe it's volunteer, and meets after hours.
6:02 pm techcommdood: +1 RT @cherimullins: Onus is on all. Change comms s/b institutionalized. Re: #tcchat Burden on [Corp Comm to communicate changes], not TCs.
6:03 pm techcommdood: PLz explain... RT @2moroDocs: Corp Comm can't change branding quickly much these days. Too much going on in the world w/social media #tcchat
6:03 pm kemulholland: @cherimullins #tcchat In many cases this requires fixing organizational problems that go beyond corp comm & tech comm.
6:03 pm 2moroDocs: There sure was a lot of ground covered today re SGs. I thank everyone for ur participation & helpful thoughts. #tcchat
6:04 pm 2moroDocs: Can keep discussing all this if you'd like, of course #tcchat If anyone has good links, pls post them #tcchat
6:04 pm 2moroDocs: @content2000 I'll look at this later & bring it up in S2 as well #tcchat
6:05 pm cherimullins: My forte! @kemulholland: #tcchat In many cases this requires fixing organizational problems that go beyond corp comm & tech comm.
6:05 pm 2moroDocs: @techcommdood I mean that companies need 2 b aware of possible chgs to brand due to feedback by ppl in FB, T, etc. #tcchat (con't)
6:06 pm 2moroDocs: @techcommdood Did you see what happened when The Gap rolled out a new logo, and everyone slammed it? They ended up changing it back #tcchat
6:07 pm 2moroDocs: I have to say, I agreed with the crowd on that logo change. Amazing how quickly it changed back #tcchat
6:09 pm 2moroDocs: @cherimullins Exc example of when the "communicator" role of TWs comes into play. We r sometimes the go-between #tcchat
6:11 pm kemulholland: Great #tcchat - thanks, everyone (especially @2moroDocs)! @techcommdood wd luv 2 switch 2 long-form comm & continue discussing l8r.
6:13 pm 2moroDocs: Was an excellent discussion in S1 about style guides in #tcchat just now. Many topics & considerations raised. Ck trans later #techcomm
6:16 pm 2moroDocs: @kmdk Good points. We didn't even touch on localization considerations #tcchat
6:17 pm 2moroDocs: @kemulholland TY, Karen. Great input, as always #tcchat
6:19 pm 2moroDocs: I really think 2day's S1 discussion will help new writers bld SGs, & existing writers 2 b aware of the many considerations 2 address #tcchat
6:27 pm rahelab: RT @CharJTF: #tcchat You can build all sorts of info into template. Just make sure people use it to create doc (not assign it after).
6:37 pm techcommdood: @2moroDocs Yes. Gap was classic case of brand change in a vacuum/not knowing their customers' likes, expectations #tcchat
6:38 pm robocolumn: Sorry. Was not able to make today's #tcchat but will read the transcript and tweet any thoughts after.
7:00 pm 2moroDocs: @robocolumn No worries! We missed ya. See you at another #tcchat, no doubt. :)
7:01 pm 2moroDocs: Am seeing some tweets still coming in. Feel free to comment throughout the day. This is topic of the day #tcchat