WTHashtag Logo

#tcchat

wthashtag.com/tcchat

Transcript from December 2, 2010 to December 3, 2010

All times are Pacific Time
 
December 2, 2010
3:00 am KnowledgeBishop: In 24 hours, join #TCchat session 2 to discuss "Minimalism in #TechComm"
3:20 am kirstyt: Fri, 1pm Aus Eastern Standard, 2pm Aus Eastern Daylight RT @KnowledgeBishop: Ioin #TCchat session 2 to discuss "Minimalism in #TechComm"
3:26 pm ermphd: Morning tweeps. Some minimalism links for today's #TCchat 1) Minimalism in #Techcomm frm wiki http://bit.ly/dLYMGl (1 of 6)
3:30 pm ermphd: minimalism link #2 http://bit.ly/dLYMGl .pdf from STC #TCchat
3:31 pm ermphd: minimalism link #4 A discussion on minimalism in #Techcomm http://bit.ly/eK6tX6 #TCchat
3:34 pm ermphd: minimalism link #5 Minimalism Designing Simplicity -book http://bit.ly/eK6tX6 #Techcomm #TCchat
3:36 pm ermphd: minimalism link #6 A 10 step guide to superb minimalist photography http://bit.ly/finZ7y #Techcomm #TCchat
3:42 pm 2moroDocs: Thank you for posting all the links to articles about minimalism today, Ed! Great info for today's #tcchat -
4:00 pm KnowledgeBishop: In 1 hour, join #TCchat session 1 to discuss "Minimalism in #TechComm"
4:00 pm robocolumn: RT @KnowledgeBishop: In 1 hour, join #TCchat session 1 to discuss "Minimalism in #TechComm"
4:21 pm ermphd: RT @KnowledgeBishop: In 1 hour, join #TCchat session 1 to discuss "Minimalism in #TechComm"
4:28 pm 2moroDocs: Minimalism #tcchat main topics: definition, what/how much to cut, content/task analysis, methodologies such as controlled vocab, single-src
4:36 pm kemulholland: Oh bleh. I have a meeting scheduled over the top of #tcchat today! I may be along toward the end of the chat, though.
4:45 pm 2moroDocs: 15 mins, peeps. #Techcomm *live* - #tcchat. Put on your song of choice & let's rock. (Springsteen 4 me today). See ya!
5:01 pm 2moroDocs: Welcome to today?s #tcchat! Topic: Minimalism
5:01 pm 2moroDocs: Reminders: please don?t use #techcomm tag. It will overwhelm it. Add #tcchat to your tweets. Thx! Also, no proprietary info!
5:01 pm 2moroDocs: Announcement: #tcchat moving to Weds, effective next week. Times: 9am and 6pm PT. Will update info everywhere.
5:02 pm PattyBlount2: Hi! #tcchat - I will be in /out. (Coworker with broken foot needs aid. )
5:02 pm 2moroDocs: Note: will post ques using @TC_Chat. Then you can open that feed & easily see current questions #tcchat
5:02 pm 2moroDocs: Main topics: definition, what/how much to cut, content/task analysis, methodologies such as controlled vocab, single-src #tcchat
5:03 pm 2moroDocs: @pattyblount2 Hey Patty! Good to see ya #tcchat
5:03 pm 2moroDocs: OK. Let?s rock! Time for tech comm *live* Who?s all here? #tcchat
5:04 pm robocolumn: RT @2moroDocs: Main topics: definition, what/how much to cut, content/task analysis, methodologies such as controlled vocab, single-src #tcchat
5:04 pm TC_Chat: Q1: What is minimalism in tech comm? #tcchat
5:04 pm robocolumn: @2moroDocs and me! #tcchat
5:05 pm coffeethenwrite: Hi all - attending from Colorado. #tcchat
5:05 pm 2moroDocs: @coffeethenwrite @robocolumn Hi! Welcome! #tcchat
5:05 pm coffeethenwrite: For me, most important is that minimalism is task based #tcchat
5:06 pm PattyBlount2: A1: #tcchat Minimalism = writing only what's needed to perform a task to spec w/out extraneous fluff
5:07 pm 2moroDocs: For me also, use as few words as possible #tcchat
5:08 pm robocolumn: @coffeethenwrite Interesting! Does that matter more for a DITA environment? #tcchat
5:08 pm 2moroDocs: The trick is finding out what can be cut, what is too much #tcchat
5:09 pm PattyBlount2: Had a boss who used to say "I don't need to know about sundials or the earth's rotation when I ask 'What time is it?'" #tcchat
5:10 pm robocolumn: @PattyBlount2 LOL Patty. How true that is. #tcchat
5:10 pm coffeethenwrite: @robocolumn Not at all. Just basic minimalism technique as I've read from research I've done. #tcchat
5:10 pm 2moroDocs: @pattyblount2 Great example! #tcchat
5:11 pm 2moroDocs: Part of it is splitting conceptual frm task (hence topic types). IMO, if u can get away w/intro sentences & no concept topic, great #tcchat
5:11 pm ermphd: Opps, sorry I'm late checking in good AM all #TCchat
5:12 pm PattyBlount2: For orgs assessing us on page/word count, content bloat results. But it's all just noise. Min should focus on opt. task perf. #tcchat
5:12 pm robocolumn: @ermphd Morning Ed from a VERY cold and snowy SE England. Hope your insight warms us up #TCchat
5:13 pm 2moroDocs: @coffeethenwrite Have u more info re basic technique? #tcchat
5:13 pm coffeethenwrite: ack - twubs not working for me today! #tcchat
5:13 pm ermphd: Well said!, Patty! RT @PattyBlount2: A1: #tcchat Minimalism = writing only what's needed to perform a task to spec w/out extraneous fluff
5:14 pm TC_Chat: Q2: What types of info do you cut? #tcchat
5:14 pm 2moroDocs: @ermphd Hi Ed. Glad to see you here. Thx for the links earlier #tcchat
5:14 pm coffeethenwrite: @2moroDocs I was just digging for my research :) there's the Nuremburg Funnel and related papers. Let me dig 4 ones I really liked. #tcchat
5:15 pm ermphd: A2 as per my prior comment. I seek to slice everything that is NOT task oriented, no feature dumps! #TCchat
5:15 pm 2moroDocs: @coffeethenwrite Thanks! If u could provide links & use #tcchat tag, they'll be in the daily paper so we can find later
5:16 pm cebrouillard: We just did a CRUFT review of our Help system. Helped with minimalism. http://bit.ly/euTScR #tcchat
5:16 pm PattyBlount2: Q2: for software, can cut the "how it works" explanations. Nobody cares unless it doesn't work. Then, Troubleshooting. #tcchat
5:16 pm 2moroDocs: One thing I cut as much as possible is screen shots. And I write in as few words as poss. Cutting even more these days #tcchat
5:17 pm ermphd: @PattyBlount2 Perfect, trouble shooting tied to tasks #TCchat
5:17 pm 2moroDocs: @cebrouillard I'll ask - CRUFT is acronym for ? #tcchat
5:18 pm coffeethenwrite: @2moroDocs #tcchat Minimalism research: Ten Misconceptions about Minimalism in IEEE pub - van der Meij and Carroll
5:18 pm ermphd: @2moroDocs Hmmm, if the screen shots show the process more simply then the text, I think the user prefer them #TcChat
5:18 pm PattyBlount2: @2moroDocs Agree; screen shots can be cut. Diagrams and illustrations that won't change with ea. release = more effective. #tcchat
5:18 pm robocolumn: @2moroDocs I'd agree with you with screen shots but some others are less easily swayed. Some users love them. #tcchat
5:19 pm 2moroDocs: @ermphd Can c that. Case-by-case. If I use them, aim to use excerpts instead of entire screen if poss. Depends on content/app #tcchat
5:20 pm robocolumn: Changing a screen shot can take more time to update that the text (e.g. setting up data) #tcchat
5:20 pm ermphd: @robocolumn Agree the screen shots provide context to users. I use them carefully, but like to keep some in #TCchat
5:20 pm cebrouillard: @2moroDocs C= correct, R=read, U=understood, F=followed, T=trusted. #tcchat
5:21 pm larry_kunz: A2: You can cut intro text ("The following yada yada") and by changing text-heavy steps to a table. #tcchat
5:21 pm 2moroDocs: @robocolumn That's true. Think it depends on what you're documenting. Some need/want screen shots 4 each step. #tcchat
5:21 pm 2moroDocs: @cebrouillard Thank you! #tcchat
5:21 pm ermphd: @2moroDocs Agree Julie. I think the key is context and keeping them simple #TCchat
5:22 pm larry_kunz: My rule is to NOT have screen shots unless there's a very, very good reason to include them. #tcchat
5:22 pm robocolumn: @larry_kunz Welcome Larry and well said #tcchat
5:22 pm 2moroDocs: @larry_kunz Tables. Good point. I usually cut table row headings. #tcchat
5:23 pm 2moroDocs: Screen shots are always a maintenance issue as well. Major consideration, IMO. #tcchat
5:23 pm ermphd: @larry_kunz My rule is to use them WHEN they provide clearer context then the text alone #TCchat
5:23 pm robocolumn: I find that as a user I somethings get confused by screenshots - like clicking on them and wondering why nothing happens - Doh! #tcchat
5:24 pm 2moroDocs: The #tcchat Daily is out - read this Twitter newspaper on http://bit.ly/cmIR1t (2 contributions today)
5:24 pm 2moroDocs: @ermphd Gd point. Also applies to graphics. Sometimes it's better to make a quick graphic to use instead of text #tcchat
5:24 pm ermphd: @robocolumn BUOD error (Bad User On Device) lol #TCchat
5:25 pm cebrouillard: @2moroDocs More graphics can also make translation faster. #tcchat
5:25 pm TC_Chat: Q3: re cutting content: how much is too much? #tcchat
5:25 pm ermphd: @2moroDocs #Techcomm writers need to adapt to "words+" Graphics/scree shots support, but don't replace text #TCchat
5:26 pm robocolumn: @ermphd Goes to show you thought that they are not to everyones taste. Personally I rarely think they add anything at all #TCchat
5:26 pm ermphd: A3 when the users can't function with the reduced doc, then the cuts are too deep #TCchat
5:27 pm 2moroDocs: @ermphd Gd point. Also need to think abt how graphics of any sort display on diff computers, mobile, etc. #tcchat
5:27 pm robocolumn: A3: Bare in mind that graphics aren't searchable #tcchat
5:28 pm ermphd: @2moroDocs Our whole #Techcomm world keeps expanding, hence more attention to other media/devices #TCchat
5:28 pm coffeethenwrite: @2moroDocs @ermphd #tcchat Anyone do usability testing with mobile? Do you check how your docs look on mobile?
5:28 pm 2moroDocs: A3: I'm not fond of proc topics that just say click this, click that with no explanation of a field - if it's not obvious. #tcchat
5:29 pm larry_kunz: A3: Too much is when you cut conceptual or background info the customer needs to make the right selection. #tcchat
5:30 pm ermphd: @coffeethenwrite Clealy usability tested badly needed. As the no. of platform types increases, testing becomes more critical #TCchat
5:30 pm 2moroDocs: @coffeethenwrite I think there has been usability testing for mobile. I've seen refs for it. Will check later. I wld ck on mobile #tcchat
5:30 pm robocolumn: A3: Graphics can be used to replace large text chunks BUT there has to be text so that users can search on it. It's a fine line #tcchat
5:31 pm 2moroDocs: A3: one more reason to work with support. If they get calls cuz there's not enough in docs, then cut 2 much. Also, more UGC on web #tcchat
5:31 pm ermphd: @robocolumn Good point Colum. In Adobe captivate one can extract the captions hence making them searchable if attached to topics #TCchat
5:32 pm 2moroDocs: @robocolumn Exc point re searching. Definitely critical consideration, as more ppl searching in Google, etc for docs #tcchat
5:33 pm ermphd: @larry_kunz To your point, text that supplies context or background is critical and should be edited VERY carefully #TCchat
5:33 pm 2moroDocs: Definitely need to use those alt tags for graphics #tcchat
5:33 pm robocolumn: @2moroDocs UGC raises some other issues which we have less control over. How do we minimise that? #TCchat
5:34 pm robocolumn: Indeed can we? RT @robocolumn: @2moroDocs UGC raises some other issues which we have less control over. How do we minimise that? #TCchat
5:34 pm Flacke: RT @larry_kunz: My rule is to NOT have screen shots unless there's a very, very good reason to include them. #tcchat -EXCELLENT!
5:35 pm robocolumn: Indeed can we or should we? RT @robocolumn: UGC raises some other issues which we have less control over. How do we minimise that? #TCchat
5:35 pm 2moroDocs: @robocolumn I think that ties 2 policy that doc team needs 2 create. If on ur site, can perhaps address. If on web, out of ur hands #tcchat
5:35 pm docboxwriter: I've usually used a motto of no gratuitous screen shots. It's like text: if it doesn't further the point, then take it out. #tcchat #tcchat
5:36 pm Flacke: RT @cebrouillard: @2moroDocs More graphics can also make translation faster. #tcchat - NO. Graphics have to be localized
5:36 pm ermphd: RT @docboxwriter: I've usually used a motto of no gratuitous screen shots. It's like text: if it doesn't further point,take it out. #tcchat
5:37 pm 2moroDocs: Just a thought. If doc team sets up forum, etc on their site, can establish org, rules, etc. Not sure u shld block/edit UGC 2 much #tcchat
5:37 pm ermphd: @Flacke Good point, images are a universal language for the most part #TCchat
5:38 pm robocolumn: @2moroDocs If it's a forum that yes I think you are right. UGC is something you have to accept flaws and all #tcchat
5:39 pm TC_Chat: Q4: What metholodogies do you use to implement? Ex: content mgmt, controlled vocabulary, DITA #tcchat
5:40 pm 2moroDocs: @robocolumn Agreed. Building community very impt these days #tcchat
5:40 pm docboxwriter: A4: Depends upon the product and target audience. Usually content management, plain English, single sourcing. #tcchat
5:40 pm Flacke: Minimalism:Elements to cut="about" "general info" , text about text, list of tables, list of figures, glossary, waranties, #TCChat #TechComm
5:41 pm ermphd: @robocolumn UGC is hard to vet to everyone's satisfaction. Seems best to leave the warts on for the most part. ;) #TCchat
5:41 pm 2moroDocs: A4: controlled vocab a personal fav of mine. Everyone using same term everywhere. Helps much w/content & translation #tcchat
5:43 pm 2moroDocs: Cont mgmt good to focus on. Write generic topics applicable for core tasks, and custom topics only as needed #tcchat
5:43 pm Flacke: RT @2moroDocs: A4: controlled vocab a personal fav of mine. ..and _a Style Guide!!!_Helps much w/content & translation #tcchat
5:44 pm cebrouillard: A4: Do most of you use content management systems? #tcchat
5:44 pm 2moroDocs: @flacke Exc point re style guides. A controlled vocab enables u to create a style guide of sorts for an entire co. #tcchat
5:45 pm ermphd: @2moroDocs Well said, Julie Good content mgt is a key factor #TcChat
5:45 pm robocolumn: @Flacke Exactly. Our style guide is our bible #tcchat
5:45 pm docboxwriter: @cebrouillard Most of our doc is in a wiki. Do you consider a wiki as a content management system? #tcchat
5:46 pm coffeethenwrite: RT @Flacke :Elements to cut="about" "general info" , text about text, list of tables, list of figures, glossary #TCChat #TechComm <agree!
5:46 pm robocolumn: @cebrouillard We do use a content management system but not for our docs! Just for our doc processes!!! #tcchat
5:46 pm cebrouillard: @docboxwriter Absolutely! #tcchat
5:46 pm ermphd: @2moroDocs Content mgt certainly helps maintain proper focus #TCchat
5:47 pm ermphd: @docboxwriter Wiki is a primitive content mgt system, but certainly better than none, #TcChat
5:47 pm coffeethenwrite: @coffeethenwrite @Flacke #tcchat - warranties you might not be able to cut, and I do like glossaries - can be critical for understanding
5:48 pm 2moroDocs: Speaking of style guides, anyone interested in making global style guide/controlled vocab? Another dream. Can start GoogleDocs file #tcchat
5:48 pm ermphd: @coffeethenwrite Agreed, cutting warranties presents legal issues and glossaries are useful for many users, #TCchat
5:49 pm Flacke: RT @coffeethenwrite: #tcchat - warranties you might not be able to cut, and I do like glossaries -> Do your users like glossaries???
5:49 pm 2moroDocs: I'm always dreaming up something, but I think global item would be cool. I think I'll just put up a spreadsheet & see what happens #tcchat
5:50 pm docboxwriter: @Flacke @coffeethenwrite Are the glossaries presented in a user-friendly format? #tcchat
5:50 pm Flacke: RT @coffeethenwrite: #tcchat - warranties you might not be able to cut->put them in a separate "Warranty and safety manual"
5:51 pm coffeethenwrite: @Flacke #tcchat - always the users come first! :) Writing for UNIX applications - different products use exact same term differently
5:51 pm docboxwriter: @2moroDocs Sounds like a great idea. Interesting to see what happens with it. #tcchat
5:51 pm 2moroDocs: I like glossaries. Especially if using a contr vocab. Enables u 2 cut info from proc. New users can look it up. Others won't need to #tcchat
5:52 pm coffeethenwrite: @Flacke #tcchat Examples that come to mind are "server" and "image"
5:52 pm Flacke: RT @2moroDocs: Speaking of style guides, ...making global style guide/controlled vocab? #tcchat ->which language? Which industry?
5:53 pm 2moroDocs: @flacke I see what you're saying. Good point. Big enough to stand on its own. Accessed only as needed; not as much as docs #tcchat
5:55 pm 2moroDocs: @flacke Languages would b big part of it. As many as poss. Industry? Start w/tech comm. Could set up guide for indiv industries #tcchat
5:55 pm 2moroDocs: Oh my gosh. Only 5 mins left! Any final thoughts? #tcchat
5:56 pm Flacke: RT @2moroDocs: Making global style guide/controlled vocab? #tcchat --> EXISTS already. See ASD (aeronautics) formerly AECMA #Techcomm
5:56 pm ermphd: @2moroDocs Your global style guide is a very ambitious project. Seems like it needs a grant #TCchat
5:56 pm lrmeyer747: RT @2morodocs: The #tcchat Daily is out - read this Twitter newspaper on http://bit.ly/cmIR1t (2 contributions today) #techcomm
5:57 pm docboxwriter: Style guides might be a good topic. #tcchat
5:57 pm 2moroDocs: @flacke Great! Good to know. If anyone knows of others, let's hear about them. We should start using, or at least reviewing #tcchat
5:57 pm Flacke: RT @2moroDocs: Only 5 mins left! Any final thoughts? #tcchat Don't forget TASK ANALYSIS to evaluate User's needs. #Minimalism
5:58 pm coffeethenwrite: @2moroDocs #tcchat - thanks so much for this chat!
5:58 pm 2moroDocs: @ermphd Nah. I see it more as a grass-roots project at this point. Could see what happens & go from there #tcchat
5:59 pm ermphd: @2moroDocs @flacke Everything #Techcomm should begin with a sound analysis, else we are wasting everyone's time #TCchat
5:59 pm 2moroDocs: @flacke Boy, you're sure bringing up a lot of good reminders for us today. style guides, task analysis ... Thanks! #tcchat
6:00 pm 2moroDocs: Yep. Sorry about that, folks. Didn't get to the task analysis ques. If anyone has thoughts on that, pls go ahead & share 'em #tcchat
6:00 pm ermphd: Good chat everyone. Some good thoughts here. My links will be in the paper tomorrow #TCchat Ciao everyone!
6:01 pm 2moroDocs: @coffeethenwrite YW. Thanks so much for coming. Great insight; helps a lot #tcchat
6:01 pm docboxwriter: Good, thought-provoking chat today. #TechComm people are fascinating. #tcchat
6:01 pm robocolumn: @2moroDocs Thanks again everyone. I can smell cooking from the kitchen so it must be dinner time. 'til next week #tcchat
6:02 pm 2moroDocs: @docboxwriter Good idea. I'm planning for Jan now, so will keep that in mind #tcchat
6:03 pm 2moroDocs: @ermphd Thx, Ed. Glad you could b here today. Appreciate your thoughts. And thanks much for all the links you posted. #tcchat
6:04 pm 2moroDocs: @robocolumn Thanks so much for coming today! Good points re screen shots & UGC. Appreciate your fitting it into your sched. #tcchat
6:05 pm 2moroDocs: Reminder: next week, this will be on Wednesday. Should enable more to participate more easily. Thx! #tcchat
6:05 pm robocolumn: @2moroDocs No probs. I always get more out than I expect. Same for us all I guess #tcchat
6:08 pm 2moroDocs: @robocolumn That's my hope. :) Thanks, everyone, for sharing your thoughts & tips! #tcchat
6:44 pm 2moroDocs: @kemulholland So true. Use x-refs 2 direct 2 your app terms; trains users. If an industry term, use that. Controlled vocab #tcchat #techcomm
6:48 pm 2moroDocs: Minimalism not just abt cutting topic info. Also abt managing content 2 maximize usage: reduce repetition & need 2 explain #tcchat #techcomm
6:50 pm 2moroDocs: @kemulholland YES! Totally agree. It is possible to gently train the user, not just give them info they need #techcomm #tcchat
 
December 3, 2010
2:09 am TC_Chat: Hey peeps! S2 of #tcchat starts in less than an hour. Topic: minimalism. See you there! #techcomm Next week we switch to Weds/Thurs
2:10 am 2moroDocs: Hey peeps! S2 of #tcchat starts in less than an hour. Topic: minimalism. See you there! Next week we switch to Weds/Thurs
2:13 am lindaurban: Hurray for @TC_Chat move next week to Wed/Thurs #techcomm #tcchat
2:17 am 2moroDocs: @lindaurban Grt, Linda! Hope you can make it. Seems that Weds/Thurs will work well for a number of folks. Will still have 2 sessions #tcchat
3:01 am 2moroDocs: Hi folks. S2. Kickin? off. Welcome to today?s #tcchat! Topic: Minimalism
3:01 am 2moroDocs: Reminders: Add #tcchat to your tweets. Use of #techcomm for all will overwhelm that tag. Thx! Also, no proprietary info!
3:02 am 2moroDocs: Announcement: #tcchat moving to Weds, effective next week. Times: 9am and 6pm PT. Will update info everywhere.
3:03 am 2moroDocs: Note: will post ques using @TC_Chat. Then you can open that feed & easily see current questions #tcchat
3:03 am 2moroDocs: Main topics: definition, what/how much to cut, content/task analysis, methodologies such as controlled vocab, single-src #tcchat
3:05 am sarahmaddox: Hallo all at #tcchat
3:07 am 2moroDocs: @sarahmaddox Hi Sarah! Glad to see you here. Sending a ques in a sec #tcchat
3:07 am sarahmaddox: Has anyone read Joann Hackos "An Application of the Principles of Minimalism to the Design of Human-Computer Interfaces"? #tcchat
3:07 am 2moroDocs: Q1: How would you define minimalism in tech comm? #tcchat
3:07 am Kristil: RT @2moroDocs: Q1: How would you define minimalism in tech comm? #tcchat
3:08 am 2moroDocs: Am having all sorts of tech difficulties here. Both in T and Hootsuite. #tcchat
3:09 am Kristil: @sarahmaddox Nope, but I'm adding it to my list now. #tcchat
3:09 am sarahmaddox: A1: #tcchat Don't know much about it. Very interested tho. Task-oriented guides and especially within the user's domain?
3:10 am sarahmaddox: @Kristil #tcchat Cool :) do you have any other interesting docs on your reading list about minimalism?
3:10 am 2moroDocs: I see it as cutting content as much as possible. Think task analysis impt part of it. #tcchat
3:11 am 2moroDocs: @ermphd posted some links earlier today on #tcchat tag
3:12 am 2moroDocs: Hootsuite down. jumping to tweetdeck. #tcchat
3:12 am kirstyt: #tcchat Hi there, back from lunch! ;)
3:13 am kirstyt: @sarahmaddox I don't think so - is it a whitepaper? Article? #tcchat
3:13 am Kristil: A1: Based on an #stc cert course and experience since then=separate info types, know your audience so you don't add clutter w/TMI. #tcchat
3:14 am kirstyt: #tcchat A1: Not verbosity. What is essential; no more. Action/result based, not overly conceptual.
3:14 am sarahmaddox: @kirstyt Here's a link to the PDF of Joann Hackos's article http://bit.ly/e4HuXn #tcchat
3:15 am 2moroDocs: @kristil @kirstyt good to see you here! thx - #tcchat
3:15 am 2moroDocs: Something came 2 mind from S1... #tcchat
3:15 am DonaldHines: @2moroDocs Concision. #tcchat
3:16 am Kristil: That course helped me quite a bit. Ended up blogging about it: http://is.gd/i7zfT #tcchat
3:16 am 2moroDocs: Breaking off items big enough to stand on their own cld cut clutter (like warranty info, glossary) #tcchat
3:16 am Kristil: @2moroDocs Hi, congrats on the FB page. #tcchat
3:17 am kirstyt: #tcchat A1: Also, concise writing. No superfluous words. Perhaps also only covering the most critical topics?
3:18 am Kristil: RT @sarahmaddox Here's a link to the PDF of Joann Hackos's article on minimalism in HCI: http://bit.ly/e4HuXn #tcchat #ux
3:18 am 2moroDocs: RT @DonaldHines Concision. #tcchat Hi there! Love that minimalist def! Perfect example
3:19 am 2moroDocs: @Kristil Thanks. I'm pretty excited about it. Working on a graphic. Will think minimalist - #tcchat
3:19 am 2moroDocs: Which reminds me. Came up earlier: do graphics/screenshots help or hurt minimalism? #tcchat
3:20 am 2moroDocs: @kristil thanks for the links - #tcchat
3:20 am Kristil: @sarahmaddox None that are re:minimalism per se. I'm reading up on audience research to achieve minimalism. What to leave out. #tcchat
3:21 am kirstyt: #tcchat Graphics might help, screenshots I don't think help. They don't inherently provide instruction, they provide reassurance.
3:22 am 2moroDocs: @Kristil Good point. Next ques ... #tcchat
3:22 am 2moroDocs: Q2: What types of info do you cut? #tcchat
3:22 am ms_marques: #tcchat A1 - eliminating anything that does not add value
3:22 am Kristil: @kirstyt I work and work at being concise. Ongoing battle w/myself. But I also get irked by "concise" at the expense of "clear." #tcchat
3:24 am kirstyt: #tcchat A1: Duplicated info. Info that is linked (e.g. more info about fields on a screen). Change to imperative mood to avoid "the user".
3:24 am sarahmaddox: A2: #tcchat Cut anything that you can reasonably expect your reader to know plus anything that is irrelevant to the audience of your topic
3:24 am 2moroDocs: @kristil Tough line, sometimes, for sure. Clarity impt, though IMO. If you have to add some info sometimes, you have to, I think #tcchat
3:25 am Kristil: RT @2moroDocs: Q2: What types of info do you cut? #tcchat
3:25 am lindaurban: #tcchat Joining in the chat for a few minutes... minimalism as defined starting with John Carroll is quite different than "minimal doc"
3:26 am lindaurban: #tcchat minimalism is about creating the right content... and sometimes that can mean more, although the "more" might be "different"
3:26 am 2moroDocs: There's also always that new user/experienced user consideration #tcchat
3:26 am kirstyt: @Kristil It can be very hard without an editor's help. #tcchat
3:26 am ms_marques: @2moroDocs a picture worth 1000 words help minimalist. A screens of each dialog box hurts. Need a minimalist approach to graphics. #tcchat
3:27 am 2moroDocs: Some topics better suited for newbies. Can link to or x-ref from a topic ppl go 2 for quick reminder of how to do task #tcchat
3:27 am lindaurban: #tcchat Minimalism links from Hans van der Meij http://bit.ly/cgb2uh (he did original work with John Carroll)
3:27 am Kristil: A2: @sarahmaddox is dead on. & maybe try not to duplicate info between docs w/ same audience, esp. if not presented consistently. #tcchat
3:28 am lindaurban: #tcchat more links related to minimalism research here: http://bit.ly/dQ3bl0
3:28 am sarahmaddox: RT @lindaurban: #tcchat Joining in the chat for a few minutes... minimalism as defined starting with John Carroll is quite different than "minimal doc"
3:28 am Kristil: @kirstyt Yes, otherwise I have to wait a long time between self edits. Not efficient. #tcchat
3:29 am 2moroDocs: @lindaurban thanks for the input & links! #tcchat
3:29 am sarahmaddox: @lindaurban Ooh great, thanks! #tcchat
3:29 am Kristil: RT @lindaurban: #tcchat Minimalism links from Hans van der Meij http://bit.ly/cgb2uh (he did original work with John Carroll)
3:29 am Kristil: RT @lindaurban: #tcchat more links related to minimalism research here: http://bit.ly/dQ3bl0
3:30 am ms_marques: @lindaurban very true #tcchat
3:30 am sarahmaddox: Here's a truly awesome blog post from Greyfiti about minimalism in tech docs #tcchat #techcomm http://bit.ly/f8jf2a
3:30 am 2moroDocs: Q3: When cutting content, how far is too far? What shouldn't you cut? #tcchat
3:31 am 2moroDocs: @ms_marques Excellent point! Translation a consideration there, too. #tcchat
3:31 am Kristil: Hmmm, guess I will hold my RTs until after the chat. #Minimalism? :) #tcchat
3:32 am Kristil: RT @2moroDocs: Q3: When cutting content, how far is too far? What shouldn't you cut? #tcchat
3:32 am 2moroDocs: A3: Usability concerns seem to come up. Also accessibility, I suppose. #tcchat
3:32 am Arinianastasya: RT @lindaurban: #tcchat more links related to minimalism research here: http://bit.ly/dQ3bl0
3:33 am lindaurban: #tcchat really need to test with users, to understand what content should be there
3:33 am lindaurban: Yes! RT @2moroDocs: A3: Usability concerns seem to come up. Also accessibility, I suppose. #tcchat
3:33 am Kristil: A3: Sometimes it's ok to duplicate info, if it makes sense to provide it inline, rather than layering and linking. #tcchat
3:33 am kirstyt: #tcchat A3: As @sarahmaddox said, might depend on audience (newbie, experienced). We have some areas w/ extensive examples-maybe not needed?
3:34 am 2moroDocs: @lindaurban Do you mean task analysis up front? Usability tests? #tcchat
3:35 am lindaurban: Both are good...could depend if you have existing content> RT @2moroDocs: @lindaurban Task analysis up front? Usability tests? #tcchat
3:35 am lindaurban: #tcchat - observing users is amazing and humbling; but for planning, task analysis very important
3:36 am 2moroDocs: @kirstyt Perhaps run a content/task analysis on that? What is really needed? Does it slow down readers or make them lose interest #tcchat
3:36 am lindaurban: Very much agree on this > RT @kirstyt: #tcchat A3: As @sarahmaddox said, might depend on audience (newbie, experienced).
3:36 am ms_marques: A3 - check with customers to see if you cut too much. Sometimes its surprising how they use doc #tcchat
3:37 am sarahmaddox: When defining the audience, it's about their particular domain (as well as newbie/experienced) - what they're using the product for #tcchat
3:37 am 2moroDocs: @lindaurban If u have tons of docs, how do you decide which to focus on w/testing? Use support calls as guides? Existence of UGC? #tcchat
3:38 am lindaurban: #tcchat details could be needed by newbie, but not by expert; need to be able to layer, scaffold; when decide to cut, know who will lose
3:39 am lindaurban: Good ideas, @2moroDocs >How do you decide which to focus on w/testing? Use support calls as guides? Existence of UGC? #tcchat
3:39 am 2moroDocs: @lindaurban Agree. Also split info into diff topics & x-ref. Chunk, chunk, chunk #tcchat
3:40 am lindaurban: #tcchat where are the pain points? (do you have measurements?) But also... who is primary audience? need agreement about that
3:40 am Kristil: @lindaurban @2moroDocs And I'm starting to wonder if there is hope of convincing a company that testing is part of "good enough." #tcchat
3:40 am lindaurban: #tcchat squeaky wheel not always most important user - unless they cause support costs, and that is the measurement
3:41 am ms_marques: @Kristil I bought a cookbook that is too modular and makes me follow links to 6 different recipes so that I can make one cake #tcchat
3:41 am lindaurban: @Kristil #tcchat LOL! the road to confusion is paved with good topic-based intentions?
3:41 am 2moroDocs: My thought w/existence of UGC.: something's missing from docs. Perhaps doc cut too much. In earlier #tcchat, some thought UGC=trblshoot
3:43 am 2moroDocs: Q4: How do you conduct user and task analysis? #tcchat (15 mins left)
3:43 am lindaurban: @Kristil - yes - pitiful how few resources/little support for usability testing, access to users, in many companies, isn't it? #tcchat
3:43 am Kristil: RT @2moroDocs: Q4: How do you conduct user and task analysis? #tcchat (15 mins left)
3:44 am lindaurban: Oops - sorry - meant @ms_marques for the recipes > #tcchat LOL! the road to confusion is paved with good topic-based intentions?
3:44 am Kristil: @lindaurban Yep. Flagship products riding out on "liquor and guessing," to quote Dilbert. :) #tcchat
3:44 am 2moroDocs: What do you guys think of this: I'm thinking of making Jan "ability" month in #tcchat. Accessibility one week, usability another.
3:45 am Kristil: @ms_marques Yep, and it's worse when the content is thin or "circular" once you click to it. #tcchat
3:45 am sarahmaddox: @2moroDocs Great idea! #tcchat We can add "readability" ;)
3:45 am lindaurban: Agree @sarahmaddox: When defining audience, it's abt their domain (as well as newbie/experienced) - what they use product for #tcchat
3:46 am 2moroDocs: @sarahmaddox Great! I'm thinking of "adaptability" too, w/regard to real-time crises, etc. #tcchat That makes 4 weeks
3:46 am ms_marques: A4 - determine purpose of task, user goal, steps, what info is needed to complete task #tcchat
3:46 am Kristil: @2moroDocs I like it. #tcchat
3:46 am sarahmaddox: RT @ms_marques: Bought a cookbook that is too modular - makes me follow links to 6 different recipes to make one cake #tcchat [LOL]
3:47 am lindaurban: RT @2moroDocs: #tcchat - my thought on UGC - need for specific examples, beyond what doc writers can do (but yes - missing from doc)
3:49 am 2moroDocs: Ok. It's decided, then re Jan topics. My theme for year: Go Big or Go Home! Start off with "ability" month #tcchat
3:49 am Kristil: A4: Internally, ask Qs about user biz goals, rvw existing research, have created qualitative personas for SMEs & support to review. #tcchat
3:50 am kirstyt: #tcchat A lot of our task work is updating existing, not analysing and checking for relevantness. Unless it's new functions/products
3:50 am ms_marques: @lindaurban book is for allergy-free baking. Might make sense if you make and stock components. But not casual use. #tcchat
3:50 am lindaurban: #tcchat Back to task analysis? Me: One way or other, discover real user tasks, (observation, mrktng research, surveys, interviews)...
3:51 am 2moroDocs: Do you just test & analyze for more current docs? Leave out legacy docs? #tcchat
3:53 am lindaurban: #tcchat Indi Young has a really interesting book called Mental Models, that talks about mapping user behavior (tasks) to content
3:53 am 2moroDocs: Q5: how do you use content mgmt for minimalism? #tcchat
3:53 am Kristil: @2moroDocs Depending on size/bloat of legacy docs, task analysis could save $, improve experience. #tcchat
3:54 am lindaurban: #tcchat Indi Young Link http://bit.ly/ii4UVP
3:54 am Kristil: RT @2moroDocs: Q5: how do you use content mgmt for minimalism? #tcchat
3:54 am kirstyt: #tcchat A5: To help us easily reuse content. So we don't have 200 slight repitions/variations on the Address or Account fields, for eg.
3:54 am lindaurban: #tcchat to me, content mgmt not related to minimalism; could be related to trying for "minimal doc sets" - but not, the same thing
3:55 am 2moroDocs: Will mention my personal fav again (like earlier 2day): controlled vocabulary #tcchat
3:55 am ms_marques: @lindaurban wow, that book does sound interesting! Appeals to my cog sci background #tcchat
3:57 am 2moroDocs: @lindaurban My thought there is by applying contmgmt, can ultimately cut some content. Reuse, diff audiences... #tcchat
3:58 am lindaurban: @2moroDocs: Agree bout contmgmt to help with reuse , conditionalizing for diff audiences... #tcchat
3:59 am ms_marques: Similarly to @lindaurban, minimalism helps prepare for content management, not the other way #tcchat
3:59 am rhianna: @2moroDocs A minimal WordPress theme could be related to content mgmt minimalism #tcchat
3:59 am Kristil: @2moroDocs Do you have experience with applying controlled vocabulary? Curious how to get started. #tcchat
3:59 am lindaurban: #tcchat "minimalism" based in studies of what is required to help people learn - actually came ouf ot studies around tutorials
4:00 am 2moroDocs: @lindaurban & perhaps something as simple as cont vocab lessens need 4 content, & would meet reqs you linked 2 earlier? (a ques) #tcchat
4:00 am Kristil: RT @ms_marques: Similarly to @lindaurban, minimalism helps prepare for content management, not the other way #tcchat
4:00 am lindaurban: #tcchat Sometimes whn people use the term, they Rrelating it the research that came from that area, other times they are thinking "minimize"
4:01 am 2moroDocs: @lindaurban I'm assuming u mean minimalist principles. My thought is cont mgmt may support them. Am I way off? #tcchat
4:02 am lindaurban: #tcchat @2moroDocs Cont Mgmt Can support - but first, need model... model, not always so easy to define...
4:03 am lindaurban: #tcchat plus, clear information model not always same as minimalist model (not a bad thing, just a thing)
4:04 am 2moroDocs: @Kristil I just started creating it. Then worked w/diff groups, dev to get everyone using (if poss!) Used in docs #tcchat Just start!
4:05 am 2moroDocs: Folks, it's 8:00 here already. Can stay around for a bit, if you're up for it. Will ck more tweets now - #tcchat
4:05 am lindaurban: #tcchat aware of time... is there a theme for next week?
4:08 am 2moroDocs: The task analysis & all that applies to min & cmgmt. Think they're closely related. Can create core & custom docs, for instance. #tcchat
4:09 am 2moroDocs: Another thing to keep in mind re controlled vocab. Could be part of data definitions & xml schemas, too. Makes db mapping easier. #tcchat
4:11 am 2moroDocs: @lindaurban Yep; there is. It's Agile Programming - writing in agile environment #tcchat
4:11 am lindaurban: #tcchat need to sign off - night all - thanks for discussion
4:12 am lindaurban: #tcchat - don't know if it will work, but if I can, I may sign in next week (wed) from an STC meeting, to do a quick demo...
4:12 am sarahmaddox: Bye all at #tcchat I need to sign off now too. Thanks for a great session!
4:12 am 2moroDocs: @lindaurban Thanks, Linda! Appreciate all your thoughts and helpful links! #tcchat
4:13 am 2moroDocs: @lindaurban That would be great, Linda! TY! It'll be an hour earlier next week: 6pm PT. #tcchat
4:14 am lindaurban: @2moroDocs ah, rats. Didn't realize hour change. Might not work :-( .... maybe we can check at the end #tcchat
4:14 am 2moroDocs: @sarahmaddox Thanks, Sarah! Glad you're able to fit this in. Next week we switch to Weds/Thurs for sure #tcchat
4:16 am 2moroDocs: Thx, everyone, for your attendance this evening & great comments. Very helpful! Sorry abt all my tech difficulties. Slowed me down #tcchat
4:17 am kirstyt: #tcchat Sorry, work intervened :) Thanks for the chat, even if I was a bit scattered today!
4:18 am 2moroDocs: @rhianna Good point. Do you know of any themes in particular? #tcchat
4:19 am 2moroDocs: @kirstyt Thanks for coming today! Know it can be tough in midst of busy day #tcchat
4:30 am 2moroDocs: @sarahmaddox @kirstyt @Kristil @lindaurban @ms_marques @DonaldHines @rhianna Thx for participating in today's #tcchat -
4:32 am rhianna: @2moroDocs David Airy has release a free Minimal WordPress theme http://www.davidairey.com/minimal-wordpress-theme/ #tcchat
4:35 am rhianna: @2moroDocs Matt Lambert @cardeo is a designer with a minimalist focus. His layouts are great #tcchat
4:36 am 2moroDocs: @ermphd @robocolumn @flacke @PattyBlount2 @coffeethenwrite @cebrouillard @docboxwriter @larry_kunz Thx for participating in 2day's #tcchat
4:39 am 2moroDocs: Thanks for those WordPress minimalist themes, @rhianna Good to know about! #tcchat
4:40 am Kristil: #Agile + minimalism in user documentation #tcchat #techcomm http://bit.ly/f8jf2a via @sarahmaddox
4:41 am ms_marques: Thanks @2moroDocs for another great #tcchat
4:45 am 2moroDocs: @kristil @sarahmaddox Grt link, esp since next week is agile. Sometimes info frm earlier chats applies 2 others. Nice 2 connect dots #tcchat
4:46 am 2moroDocs: Everyone be sure and review the #tcchat paper that comes out 2moro. Will have many good links re minimalism #techcomm
5:48 am dkraks: RT @sarahmaddox: Here's a truly awesome blog post from Greyfiti about minimalism in tech docs #tcchat #techcomm http://bit.ly/f8jf2a
6:07 am Flacke: RT @2moroDocs: @lindaurban...I've learned a lot about time zones as a result of this chat! January topic: how to cyber-invite in UTC!#TcChat
7:06 am cfidurauk: RT @dkraks: RT @sarahmaddox: Fantastic blog post from Greyfiti about minimalism in tech docs #tcchat #techcomm http://bit.ly/f8jf2a
7:09 am cfidurauk: RT @2moroDocs: @kemulholland YES! Totally agree. It's possible to gently train the user, not just give them info they need #techcomm #tcchat
1:46 pm juliov27612: Are robots taking our jobs? http://tinyurl.com/2by79ps Great post by @larry_kunz #techcomm #tcchat
2:46 pm richardhamilton: RT @juliov27612: Are robots taking our jobs? http://tinyurl.com/2by79ps Great post by @larry_kunz #techcomm #tcchat
3:55 pm content2000: Question for the #tcchat and #techcomm community - what does 'ease of use' for documents mean to you? (trying to build preso/case for it)
4:30 pm lrmeyer747: I #follow @2moroDocs for leading valuable, informative #tcchat sessions. #techcomm
4:52 pm NancySlawski: Ease of use: Doc purpose is clear & format, style & content reflects context and need of user - usability @content2000 #tcchat #techcomm
5:24 pm 2moroDocs: The #tcchat Daily is out - read this Twitter newspaper on http://bit.ly/etUma8 (8 contributions today)
6:04 pm 2moroDocs: RT @richardhamilton: RT @juliov27612: Are robots taking our jobs? http://tinyurl.com/2by79ps Great post by @larry_kunz #techcomm #tcchat
6:08 pm 2moroDocs: Ease of use: clear, concise. more white space than clutter so can scan. findable. targeted. there exactly when & where needed. #tcchat
6:12 pm 2moroDocs: How Tech Writers Can Make Themselves Heard http://bit.ly/euXItu #tcchat #techcomm
6:27 pm content2000: @NancySlawski @2moroDocs Thanks folks for ease-of-use help! #tcchat #techcomm
6:31 pm 2moroDocs: Minimalism links. Look at 12/2 and 12/3 RT @2morodocs: The #tcchat Daily is out - http://bit.ly/etUma8 (8 cont today) #techcomm
8:32 pm cardeo: RT @rhianna: @2moroDocs Matt Lambert @cardeo is a designer with a minimalist focus. His layouts are great #tcchat