web 2.0

and its impact on technical
communication

presented by Scott Abel,  The Content Wrangler,  Inc.
scott abel

nightclub dj,  investigative reporter,  technical
writer,  trouble-maker,  entrepreneur,  evangelist

 Ix

Tam...
for change

technical writing skills are easy to duplicate; 
user expectations are changing faster than we are

    

 
  ...
what’s your difference? 

Microsoft Word mastery does not adequately differentiate; 
neither do good grammar,  correct pun...
future—proof career

highly sought after skills,  easily transferable to other areas of business; 
skills must provide pos...
in demand skills

information architecture,  interaction design,  modular content creation, 
localization and translation,...
document engineer

documents were only interfaces for people; 
documents are now interfaces to business services and proce...
changing expectations

look outside of technical communication for examples; 
user expectations are changing MUCH faster t...
mobile devices

portable,  powerful,  and personalized; 
handheld devices have changed user expectations
alcilgdu ?  10:15 All -

‘G
You

Ctltvldlr Photon Canon

Clcuuu smell

""' P I
I 
Nous

unoawumu

Cloelt swings

 

iPhone...
web 2.0

leverages the internet as an operating system to
deliver service;  helps users “do stuff”
playable search

allows users to find and play multimedia
content from within a web browser
seeqpod

helps you find and listen to music almost
instantaneously;  it also works for videos
helps you remember what you don’t want to forget; 
audio in,  text out
tape failure

no more guessing what website users like; 
watch them use your site and make
changes based on real user expe...
tagging

tagging helps us stay organized; 
sharing tags helps us help others quickly; 
what we tag can help improve docume...
mashups

looking at content from all angles helps us make
meaningful decisions;  combining content makes
content accessibl...
A PERIODIC TABLE OF VISUALIZATION METHODS

> t} <
c DataVisua| ization Strategy Visualization

Vfiutll rrvmmwwnx oraoanumm ...
mashup that allows users to sort,  filter,  and visualize
content in various ways without a database
web 2.0

syndication allows users to remix content; 
structured content makes it possible
yahoo!  pipes

syndication allows users to remix content; 
structured content makes it possible
really simple syndication

an XML standard; 
provides structure and semantic value to content

Efite 

Q‘


~. l
publish/ subscribe

extends the reach of content; 
users reuse content in unlimited ways
pubhsh

write it once and let go of control; 
content is both human and machine readable
subscnbe

services provide relevant information, 
delivered how,  when,  and where users want it
hosted software

online office applications are exploding in
popularity;  open standards and ease of use drive
adoption;  ...
Gouglc Docs & Spreadsheets aklsflneldiwanmlilwelflgmm

Untm9d c-cm or S: :pir: Fl‘br: r 1: 22:7 5 l8 PM by / br; l;p Save Sa...
‘IL:  itiilii:  WI HI-iii‘—. ii

ri il: ii. i:p: ii ii

ThinkFree Docs

Find the document you need now from
the published ...
L34‘ -131
Work Ol‘ililC

[2 Zoho Writer
Online WDYU PfO%SSOf

 Zoho Sheet
"’ spreadsneetsonllne

E Zoho Show
Online Presen...
XML word processors

97% of the world uses MS Word; 
XML word processors provide familiar interface
blogs

two new blogs are created
every second of every day
ADFS Dowmentzation
Blog

Your source for newsabom
current a nd upcoming ANS
documertation projeas. 

Recent Posts
More ADF...
web—based collaboration tools that support user-

generated content;  users can consume,  create,  correct, 
corrupt,  and...
WIKIPEDIA

En llsn
mg rm nmwpma
Mmooo.  .«m

Frangnls
L bncyc/ oped/9 am: 
no can M-. x

HI}
J‘;  ’iI: ‘3‘FP¥
 o
nanano

L...
List anonymous wikipedia edits from interesting
organizations

by Virgil Griffith v at santafe dot edu

[ media gpl are req...
wiki tools

there are many available (free to expensive)
wikis for
documentation? 

wikis are being used to create documentation; 
there’s even a wiki based on DITA
DITA Storm browser-based DITA Editor

I: dt[Dla

0 Overview

0 Online EdlCDr[i-cw)

Features
0 Sample Documents

0 DITA Su...
['—3I, ,,', )', _§A Dv Open Save Q + fl S  Prop x 1 l v insert B I
TT Image [1 XRel Note OList UList Pie Code l Borders Doc...
. Ir J DITA fromA to B
“ D A  helping you get started with topic-based structured writing

3.’ ii-iI! ——'4 CPU 1' ‘H32 - 0...
p 0 d  agts
anyone can create bad audio faster than ever! 

, “t ii
u  e r~ g   n  rated
  hie ht

users are creating their own documentation
whether you want them to or not;  they don’t
nee...
video documentation

user expectations are changing;  are you?
they’re doing it,  new

video jug,  expert village,  sclipo,  5min,  viewdo, 
teacher tube,  youtube howto
«A ll

ooze/ i

bile -9

 

 

will

V“ 9.: 

«A ll

P N —
social networks

network effects;  users share with one another
in uncensored online communities
for additional information

contact Scott Abel at TheContentWrang| er. com
317.466.1840 scottabel [at] mac [dot] com
Web 2.0 sites of interest

Save time.  Arrange meetings in a snap ——> www. meetingwizard. com
Create “to do” lists with yo...
Upcoming SlideShare
Loading in …5
×

Web 2.0 Neo Stc 2007

1,181
-1

Published on

Web 2.0 and Technical Communication presentation delivered at the NEO STC Regional Conference, The Crucial Communicator, October 2007.

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
1,181
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
27
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Web 2.0 Neo Stc 2007

  1. 1. web 2.0 and its impact on technical communication presented by Scott Abel, The Content Wrangler, Inc.
  2. 2. scott abel nightclub dj, investigative reporter, technical writer, trouble-maker, entrepreneur, evangelist Ix Tampa, Amsterdam, Indianapolis, New York City, San Diego, Key West
  3. 3. for change technical writing skills are easy to duplicate; user expectations are changing faster than we are s. . W . K ' ' , ;ec- Q, ‘ g’ , , . ... ... ... ... ... ,. .,. —-—~‘ blogs, user—generated content, handhelds, virtual worlds, podcasts, geospatial positioning
  4. 4. what’s your difference? Microsoft Word mastery does not adequately differentiate; neither do good grammar, correct punctuation, nor smooth segues
  5. 5. future—proof career highly sought after skills, easily transferable to other areas of business; skills must provide positive impact throughout your organization
  6. 6. in demand skills information architecture, interaction design, modular content creation, localization and translation, document design, standards knowledge
  7. 7. document engineer documents were only interfaces for people; documents are now interfaces to business services and processes
  8. 8. changing expectations look outside of technical communication for examples; user expectations are changing MUCH faster than we are
  9. 9. mobile devices portable, powerful, and personalized; handheld devices have changed user expectations
  10. 10. alcilgdu ? 10:15 All - ‘G You Ctltvldlr Photon Canon Clcuuu smell ""' P I I Nous unoawumu Cloelt swings iPhone Nano - iA www. inforrnationarchitects. jp . dc'f|9Ulir 10:15 AM iPhone Shuffle
  11. 11. web 2.0 leverages the internet as an operating system to deliver service; helps users “do stuff”
  12. 12. playable search allows users to find and play multimedia content from within a web browser
  13. 13. seeqpod helps you find and listen to music almost instantaneously; it also works for videos
  14. 14. helps you remember what you don’t want to forget; audio in, text out
  15. 15. tape failure no more guessing what website users like; watch them use your site and make changes based on real user experiences
  16. 16. tagging tagging helps us stay organized; sharing tags helps us help others quickly; what we tag can help improve documentation
  17. 17. mashups looking at content from all angles helps us make meaningful decisions; combining content makes content accessible in meaningful ways
  18. 18. A PERIODIC TABLE OF VISUALIZATION METHODS > t} < c DataVisua| ization Strategy Visualization Vfiutll rrvmmwwnx oraoanumm om lfi xnerncrx 17-: systtmatx us: or romoirmrnrury vrsuoi mumm- torlnnuultl rum. (timer mm or mxr-tm an-xi mm m are anar, -m, m-«augment fnmmtantxrxnrnzrmnrr cuumand rrnplrmelrlabofi or watt: -es In orpammlroru lnformattonVisualization Metaphor Visualization the use ormmtxme vmzal I. -gum-man: nfdata rn am vmmr Mrxophovx pommn mrmmamn gvapn-ml», an u. my (ogmbwr rm mm mm me limo n. mmrncmea mm gentle and summ lrrfiwrnauaa They also (orwq on EIMW‘ an . mage. n rs mapped In screen uxxa rm image an be mug»: about the mores: -nttd mfzrmotzan filrough in mvdlnim mama 9, men at Dry pnxrrd -«mung mm It A-zy (Punam-man arm mttxrphov mat a rmployrd Concept Visualization Compound Visualization Memo» Io moan rmoulyr qvalilaume concepts, rm cnrnpkmenmry ute ormmmu graph-( repluen : <1eos, plaM, ar»d anamex trrurm rmma -n one mgr: sothema or rm. . oi"'nwnurror d‘Ig'u~ rqimr I t0ll(! Ill'l£ “ oeupemm °l-‘Fm 5'5"‘ (mm : dmylm > '< >{}< . .,; ,,, ,,, ¢.. ,,, :7 . . mm cqunrd '1ue cm: ,9». /Hill] um ‘'‘i‘‘* ‘ nu mm in-. l"0d >{j}< Pr mvunm ammr mm mm , mm“ ugunenmron newt 4'I M rm:
  19. 19. mashup that allows users to sort, filter, and visualize content in various ways without a database
  20. 20. web 2.0 syndication allows users to remix content; structured content makes it possible
  21. 21. yahoo! pipes syndication allows users to remix content; structured content makes it possible
  22. 22. really simple syndication an XML standard; provides structure and semantic value to content Efite Q‘ ~. l
  23. 23. publish/ subscribe extends the reach of content; users reuse content in unlimited ways
  24. 24. pubhsh write it once and let go of control; content is both human and machine readable
  25. 25. subscnbe services provide relevant information, delivered how, when, and where users want it
  26. 26. hosted software online office applications are exploding in popularity; open standards and ease of use drive adoption; offline access now available
  27. 27. Gouglc Docs & Spreadsheets aklsflneldiwanmlilwelflgmm Untm9d c-cm or S: :pir: Fl‘br: r 1: 22:7 5 l8 PM by / br; l;p Save Save 3‘ °'°5° Discard Changes File‘ Edit Insert Revisions out I§Preview fiprini Email in m JQ g B I Q _7"~-rT- '13-g'1_2;G_E> I _ 1} Srylev Changev Google Earth Agreement: Thank you for using Google Earth! By downloading, installing or using this software or any portion thereof ("Google Software”) you agree to be bound by the following terms of service (the "Terms of Service"). The Google Software, and any portion thereof, are referred to herein as the "Software. " 1. USE OF SOFTWARE; RESTRICFIONS Use of Software. For an individual end user, the Software is made available to and may be used by you only for your personal, non-commercial use according to these Terms of Service and the Software documentation. For a business entity user, the Software may be used by you and your employees for internal use according to these Terms of Service and the Software documentation (individual end users and business end users are collectively referred to as “You" herein). Restrictions. You agree not to use the Software in connection with or in conjunction with a system in a vehicle that offers real-time route guidance or turn-by-turn maneuvers. You agree not to use the Software for any bulk printing or downloading of imagery, data or other content. 2. PRIVACY POLICY As a condition of downloading and using the Software, you agree to the terms of the Google Privacy Policy at http: //www. goog| e.com/ privacy. html, which may be updated from time to time and without notice. 3. PROPRIETARY RIGHTS a. Google. You acknowledge that (a) the Software contains proprietary and confidential information that is protected by applicable intellectual property and other laws, and (b) Google owns all right, title and interest in and to the Software, and software provided through or in conjunction with the Software, including without limitation all Intellectual Property Rights therein and thereto. "intellectual Pronerrv Riohts" ens any and all riots xistino fom tme to time unde natent law.
  28. 28. ‘IL: itiilii: WI HI-iii‘—. ii ri il: ii. i:p: ii ii ThinkFree Docs Find the document you need now from the published docs currently online and share your docs. . iiii i Vii Matt MCklSSl(k J l . on N :1.ir ‘ Jo: i.: (li. m Crow Cathei inc Kai u. :l| ill ‘ Gabi ICHL‘ Aidel Eric Boisveit Anne Gliory-Goodman ‘ Chi Istophei Raykovicli I! I‘vli l Small Business Solutions for small business: ~ i: Mi . L ThinkFree Office Online Share ThinkFree workspace. do( Revision I" Catherine l-‘tarur: -ll 01-01-2007 23:27 min ’Iiiiii: i»'u-. .r, i » “.4. Create, edit and access files from anywhere over the Web provide omce applications and enable online collaboration for a fraction of the cost. Microsoft OlTce Compatible ii-, r:ui» i. .. "IDIII-ll!
  29. 29. L34‘ -131 Work Ol‘ililC [2 Zoho Writer Online WDYU PfO%SSOf Zoho Sheet "’ spreadsneetsonllne E Zoho Show Online Presentation Tool [:3 Zoho Meeting Web Conferencing ‘_ Zoho Notebook Online Note Taker , Zoho Planner / online Organizer ff; Zoho Projects 1 ' ' Project Management Software I. -I Zoho CRM ; on-Demand CRM Solution fl Zoho Creator Create Database Applications l"fi Zoho Wiki '4} Group Wikls made easy i ' ') Zoho Chat Make Group Decisions Faster . l Zoho Mall ; Collaboration Groupware ZOHO HOWE Utilities Site 24x7 Website Monitoring Service Zoho Polls Online Polls in a snap Zoho Vlewerimi View and Share Documents Online Zoho Challenge Easlestway to Evaluate Candidates | :0ruri‘: | Blogsl Contact us Toll Free : 888 900 9646 Sign In Username: Password: I‘ Keep me signed in ii FDFQOI PBSSWOFU 7 New User? Sign Up tor Freel MB Business Reguestaclzess Zoho Start EVENTS 0 NEWS 3 lzoho View docs and DB apps in your iPhone
  30. 30. XML word processors 97% of the world uses MS Word; XML word processors provide familiar interface
  31. 31. blogs two new blogs are created every second of every day
  32. 32. ADFS Dowmentzation Blog Your source for newsabom current a nd upcoming ANS documertation projeas. Recent Posts More ADF5 1 unto-in no-I4 ovaiiabfr‘ ADf'SlOvu(>¢ Step oy Step cm. - Infioduciuq mo ADFSIIBM riyoii sun: 2:, stop Guide‘ AD F5 V1 Content 4*‘ J. |V HSDN Uudafe and a new mini’ New AD rs evn-rit based lroublcshootirlg content com ng soon coming m July. AD rs v1 sox r. c,. m-nit Tags ADFS Step-by-Step Tips : i- 'i. i,. ':w . i-iii Blogroll ADFS v-mum suuixm aioq Xdentrty Btaq ADFS Deployment Guide - Sneak Peek #2 (Name resolution requirements for FSPs) Detailed instructions for how to set up a federation server proxy (slated for the upcoming ADFS Design and Deployment guides) are currently awaiting technical review by the product team. so I can't divulge those finer details at the moment However. I think it is probably OK to let you know (at a high-level) what two primary tasks you need to complete to configure the FSP for name resolution 1 ) Add an entry to the Hosts file on the FSP machine that points to the DNS ost name and IP address of the account federation sewer An example of this. relative to the ADFS Step-by-Step Guide. would be 192.168.1.3 adfsaccount. adatum. com 2 ) Add a new host (A) record to the penrneter network DNS of the account partner that points the lP address of the federation server proxy to the DNS host name of the federation server Relative to the Step-by-Step guide, this would be done by a Using DNS Manager on the adfsaccount computer to Under the adaturn com forward lookup zone. add a new host record with the name adfsaccount and fill in the IF‘ address of your FSP machine Hopefully this will give you a pretty good idea how to set this up until the updated Design and Deployment guide content is released publicly Posted
  33. 33. web—based collaboration tools that support user- generated content; users can consume, create, correct, corrupt, and cut content
  34. 34. WIKIPEDIA En llsn mg rm nmwpma Mmooo. .«m Frangnls L bncyc/ oped/9 am: no can M-. x HI} J‘; ’iI: ‘3‘FP¥ o nanano L '5/Ac:4‘lx)D€<1Ial: DeIa :1: mm V0‘: Svenska Don ma sum/ uaodm In one. .. u : . Deutscn pm me Enzyltlopadla 4uooo. mm Folskl ’: 7;, '1 Wol/ Ia errcytlopodra m: ooo. ».. ..« Nedertanus on was enmvapodm 2:: ma. mum: Ponugués A ancm/ apedu-1 may use one. -moo: Espafiol u Inca/ upsdra I/ Dru m we. mm; search <sucM wochctcmr ~sxu<a; < ‘BA uooxun < morn >so< ~ ausca >aus: :u ~rcs<- Enghsh _J )
  35. 35. List anonymous wikipedia edits from interesting organizations by Virgil Griffith v at santafe dot edu [ media gpl are required read this before asking questions] For those who keep asking for 'speoify by title’ to be turned back on: I'm working on it, you '11 get it soon. Stop mailing me for it. Thanks. -Virgil Hello Wired, boingboing, Radar, Daily Kos, lgj, digg, L, Chronicle, Mashable, Valleywag, Guardian, US News, BBC, Times Online, Planet Chiropractic, Le Monde, Der Spiegel, El Pais, Forbes, Daily Telegraph, CBS News, heise online, Linux Insider, New York Times, Int. Herald Tribune, pugbus, flpnet, Penny Arcade, IT Blogwatch, HowStuffWorks, Time, §ydney_Morning Herald, techtarget, The Onion, Slate, WikiNews readers /9&1, Radio Canada, BBC Radio5 listeners / Colbert Regort watchers! Wikiscanner is available for English, Deutsch, Frangais, and HA? “ Wikipedia. Specify by the Organization's. .. Editor's Picks Wi'red's list of sa/ acious edits <e Type organization name here _ _ _ Submit a salacious edit or/ and Lists Location: </ Don‘! abbreviate here M0-St C°mm°” - °V'5 Most common . mil'§ Reveal my potential victims! Most common . gov. au's Most common . uk's Most common . gov. uk's .
  36. 36. wiki tools there are many available (free to expensive)
  37. 37. wikis for documentation? wikis are being used to create documentation; there’s even a wiki based on DITA
  38. 38. DITA Storm browser-based DITA Editor I: dt[Dla 0 Overview 0 Online EdlCDr[i-cw) Features 0 Sample Documents 0 DITA Support 0 Roadmap Documentation Basic Editing Editor Integration PHP Example JSP Example Javascript API Extension Points Custom XML Elements (new) Customizing Rendering (new) 0 f710dC| .)(fhl[r-cw) Download 0 Release Notes I Licensing Contact Us got. AP1.com -. . ti. .. l: :litl oiia Free Online DITA Editor This service allows to work with your local DITA documents from web browser. No installation required. You will be able to: I Create new Topic, Task, Concept or Map by clicking ‘New’ button I Open existing DITA Topic/ Task/ Concept/ Map file by clicking 'Open' button and locating xml file on your local disk. I Save modified file by clicking ‘Save’ button To try a more comprehensive project-level DITA authoring and publishing experience visit www. ditausers. org Launch Online Editor Recent Editor Enhancements: I DITA Storm now supports References I By default DITA Storm now outputs indentation-formatted XML. <tasl<> <tit| e>Lorem Ipsurn</ ’tit| e> <shortdesc>Consei: tetur ad <taskbody> < prereq >cunsectetur adi I Look at the recently added ability to edit DITA in WYSIWYG, Outline and XML modes: : ' ywsiwygj Outlirie| ><lu_1rL| You can find full list of the supported XML elements in DITA Support section as well as recent updateds to the editor functionality in Release Notes
  39. 39. ['—3I, ,,', )', _§A Dv Open Save Q + fl S Prop x 1 l v insert B I TT Image [1 XRel Note OList UList Pie Code l Borders Doctype About lit‘, -sv. vyg| Oullrm Topic: [empty title] Description: [empty short description] — Proloq Authai: [author not specified] Created: 2007-02~25 [empty paragraph] Section: [empty title] [empty section] Example: [empty title] [empty section]
  40. 40. . Ir J DITA fromA to B “ D A helping you get started with topic-based structured writing 3.’ ii-iI! ——'4 CPU 1' ‘H32 - 0 ji a. j njr —r Allis DITA from Authoring to Building Prgress Blgg i Membership Why Q) How to gr‘ Author your own DITA content online. Use the browser-based DITA Storm editor to author structured 1 content in your own workspace. You don't have to install anything Beige or know XML to begin topic-based structured writing today. s A modest investment will help you develop skills you can transfer ficffi to the top DITAXML Editors and XML Content Management —: '~ Systems 2‘ °3%'"a“, f,"f. :.E (see the extensive listings in our i section). Tools A-Z Desklgg Edrtors Web Edlzors 0 Build and publish to multiple formats. e You can have multiple projects in your personal workspace. Each s project includes source flies, build tiles, and output files. Process Efijggr, -m your files to HTML, PDF, Help. and other publishing formats with Em, “ the DITA Open Toolkit on our server. Develop your DITA skills and Sgglesheel Dr. -s'Qr*ers download the results. or publish links to your work on our website. Rcrccrrg Ergrcs Publishlrg Erglrcs Take our tools for a test drive. :1 or” 5.9, Start a project with the free online demo‘ of our DITA Manager. DITA Noam" You can author sample files, build them to create HTML, PDF, and . « T H I t . th it. “ DITA News e p ou put an browse your resu 5 mm , /ISII mo ulsl&. zommuriity I °—'Tm'i"fl9! Then join DITA Users today (51 00USDIyear). ‘ i You will get your own workspace folder and permanent storage. ‘ QITA Wlkl You also get a listing in our member directoq and discounts for ma or DITA conferences that more than offset membership cost. Is You must use Mollie Firslux orlritevviel Elplorur ‘ i ml - Al the lie; l'l the dam oroiu usnagorw be restored panoduiiy. so yourchlnges wil not be Damunenly saved ie. .i. ..= i . .. 5lViNV‘1-inrilcd tlr ldldm WorIdServer
  41. 41. p 0 d agts anyone can create bad audio faster than ever! , “t ii
  42. 42. u e r~ g n rated hie ht users are creating their own documentation whether you want them to or not; they don’t need or seek your permission
  43. 43. video documentation user expectations are changing; are you?
  44. 44. they’re doing it, new video jug, expert village, sclipo, 5min, viewdo, teacher tube, youtube howto
  45. 45. «A ll ooze/ i bile -9 will V“ 9.: «A ll P N —
  46. 46. social networks network effects; users share with one another in uncensored online communities
  47. 47. for additional information contact Scott Abel at TheContentWrang| er. com 317.466.1840 scottabel [at] mac [dot] com
  48. 48. Web 2.0 sites of interest Save time. Arrange meetings in a snap ——> www. meetingwizard. com Create “to do” lists with your cell phone ——> www. iott. com Provide differing views of your content ——> Create/ share personalized radio station — Find/ rate/ reuse slide show presentations — Find a conference; rate events/ speakers —- Tag content so you/ others can find it later ——WWW'de"i°i°'”S >*——? — . . . gg g. g Create structured content using a blog ——> WWW Stmcturedblo m or Standards for popular content types ——> aVVm'g: ,i, C:gfg(r)TnatS'Org Syndicate classifieds from your blog ——> WWW_pipeS_yahOO_COm Mashup RSS feeds and create new ones --. ;¢, WW_doC5_go0gie_COm Collaborate on spreadsheets/ documents ——>www. plazes. com Tell others where you are/ find others ——> www. twitter. com Tell others what you’re doing right now ——> www. tapefai| ure. com Watch videos of how users use your site ——>
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×