Skills and tools for tw in web2.0 era tc europe
-
Upload
alessandro-stazi -
Category
Technology
-
view
665 -
download
1
description
Transcript of Skills and tools for tw in web2.0 era tc europe
“Times they are changing…” Bob Dylan
Skills and Tools for Technical Communicators in Web 2.0 era
Author: Alessandro Stazi
TC Europe Colloquia Aix-en-Provence
25/4/2014
Briefly Alessandro Stazi, 49 years old, ICT Engineer. Documentation & Training Manager in CrossIdeas
www.crossideas.com
2 Skills and Tools for Tech Comm in Web 2.0 era
My blog
www.artigianodibabele.it
3 Skills and Tools for Tech Comm in Web 2.0 era
Once upon a time… Web 1.0
4
Web 1.0 is very alike to traditional Shannon – Weaver diagram
Skills and Tools for Tech Comm in Web 2.0 era
But Web 2.0 is arrived…
5
“Many to many” relations and contents multiplatform everywhere Skills and Tools for Tech Comm in Web 2.0 era
And Web 3.0 is already here…
6 Skills and Tools for Tech Comm in Web 2.0 era
…but contents everywhere, tagged for more intelligent searching/semantyc engines.
We can’t tag a traditional, printable manuals of 500 pages… so we must move from old, monolithic documents to new modularized contents.
Search Result
No more a “right place” to find information… (Mark Baker source, EPPO, 2014)
Web 3.0 semantyc engine
Web 3.0 example
7 Skills and Tools for Tech Comm in Web 2.0 era
Phrase in natural language into App of my smartphone “I want to eat in a typical restaurant”
Web 3.0 semantyc engine
Web Site Restaurant
XML Geo Loc Tag
GPS coordinates of my smartphone
Main Consequences
8
• Information overload • Governance through software • Contents everywhere: Mobile/Multiplatform • Contents Task/Context driven • Syndicated contents
Skills and Tools for Tech Comm in Web 2.0 era
Information Overload (1/4) One of us… in a common day…
9 Skills and Tools for Tech Comm in Web 2.0 era
Information Overload (2/4) THE PAST: user who seeks information!
10 Skills and Tools for Tech Comm in Web 2.0 era
Information Overload (3/4)
11 Spivack source, 2008
Skills and Tools for Tech Comm in Web 2.0 era
Information Overload (4/4) THE FUTURE: the information who seeks the user… because
information is CONTEXTUALIZED for user task…
12 Skills and Tools for Tech Comm in Web 2.0 era
No more “right places” (as old printable manuals) where to find information, because information are everywhere and continuously changing.
Main Consequences
13 Tutti abbiamo bisogno di un Help… On Line!
• Information overload • Governance through software • Contents everywhere: Mobile/Multiplatform • Contents Task/Context driven • Syndicated contents
Minority Report (2002)… do you remember? A so far future…
14 Skills and Tools for Tech Comm in Web 2.0 era
Tendency: software governance anywhere
Machinery and industrial processes will be managed “remotely” and “mobile”, with software GUI and visual dashboards.
The documentation for user support will be more integrated in
administration software GUI as Online Help.
15 Skills and Tools for Tech Comm in Web 2.0 era
Main Consequences
5/4/2014 16
• Information overload • Governance through software • Contents everywhere: Mobile/Multiplatform • Contents Task/Context driven • Syndicated contents
Skills and Tools for Tech Comm in Web 2.0 era
We are always OnLine and Mobile (1/2) • For the International Data Corporation (IDC), in 2020
we will have 35 billion connected mobile devices. • “…Tablet purchases by businesses will reach 13 million
units this year (2012), more than tripling by 2016 to reach 53 million units”(Gartner)
• “…On the smartphone side, Gartner is forecasting a win for Android in the enterprise… more than 56% of smartphones purchased by businesses in North America and Europe will be Android devices in 2016” (Gartner)
17 Skills and Tools for Tech Comm in Web 2.0 era
We are always OnLine and Mobile (2/2)
18
Morgan-Stanley source, 2012 Skills and Tools for Tech Comm in Web 2.0 era
Main Consequences
19
• Information overload • Governance through software • Contents everywhere: Mobile/Multiplatform • Contents Task/Context driven • Syndicated contents
Skills and Tools for Tech Comm in Web 2.0 era
Content Task/Context driven Provide the RIGHT information to the RIGHT person
at the RIGHT time in the RIGHT way
20 Skills and Tools for Tech Comm in Web 2.0 era
An example? On Line Help
21 Skills and Tools for Tech Comm in Web 2.0 era
Main Consequences
22
• Information overload • Governance through software • Contents everywhere: Mobile/Multiplatform • Contents Task/Context driven • Syndicated contents
Skills and Tools for Tech Comm in Web 2.0 era
Syndicated contents (1/2)
23 Skills and Tools for Tech Comm in Web 2.0 era
Personalized display based on: • User preferences • Community attributes • Contextual information • Other … …to receive the right contents at the right time from anywhere, joining modularized contents
Syndicated contents (2/2): Lenovo example
24 Skills and Tools for Tech Comm in Web 2.0 era
http://www.lenovopartnernetwork.com/resources/sales-tools/content-syndication
We need new competences, methods, tools!
25 Skills and Tools for Tech Comm in Web 2.0 era
Main Competences and Solutions
26
• Authoring/Publishing Topics based processes • Methodologies/Standards: DITA, IM, FD, …? • Technologies: XML, CSS, XSLT, HTML5 • Tagged Contents • Tools: CCMS/CAT • Vertical contents Task/Context driven Skills and Tools for Tech Comm in Web 2.0 era
Contents Reuse
Save time/money for updates Reduced Time to Market
Collaborative & shared writing
Contents Multi-Channel
Technology integration
XML/CSS/HTML5
Contents/Topics Data Base
Contents Multi-Language
Skills and Tools for Tech Comm in Web 2.0 era
Tagged Contents
Authoring/Publishing processes Topics based
27
Main Competences and Solutions
28
• Authoring/Publishing Topics based processes • Methodologies/Standards: DITA, IM, FD,…? • Technologies: XML, CSS, XLST, HTML5 • Tagged Contents • Tools: CCMS/CAT • Vertical contents Task/Context driven
Skills and Tools for Tech Comm in Web 2.0 era
DITA, IM, FD or other? (1/2)
29 Skills and Tools for Tech Comm in Web 2.0 era
Old monolithic contents broken in modules of different granularity…
…in which way?
DITA, IM, FD or other? (2/2)
30 Skills and Tools for Tech Comm in Web 2.0 era
• DITA (Darwin Information Typewriting Architecture) Concept-Task-Refence
• IM (Information Mapping) Procedure-Process-Principle-Concept-Fact-Structure-Classification
• FD (Functional Design) Functional Units (“speech acts”) + Consistency Rules
(Usage-Content-Sequence-Wording-Design-Marking)
• Other?
Main Competences and Solutions
31
• Authoring/Publishing Topics based processes • Methodologies/Standards: DITA, IM, FD, …? • Technologies: XML, CSS, XLST, HTML5 • Tagged Contents • Tools: CCMS/CAT • Vertical contents Task/Context driven
Skills and Tools for Tech Comm in Web 2.0 era
Technologies: XML, CCS, HTML5 (1/2) XML • Structured data • Platform indipendent
32
CSS (and more powerful XLST) • Keep separated contents layer from style & presentation layer • Same content + different CSSs = different look & contents multichannels • XML + CSS = Structure + Flexibility • XML + XSLT = Structure + Flexibility + Transformation & Logical operations
HTML 5 • Collection of .htm files direct addressable, redistribuible in any way • Integration into Web App (Internet/Intranet)/Mobile Application • Multi-browser /Multi-platform • Social networks/Multimedia interactions
Skills and Tools for Tech Comm in Web 2.0 era
Technologies: XML, CCS, HTML5 (2/2) Example The same XML content (a table) with two different CSS
33
HTML 5
Skills and Tools for Tech Comm in Web 2.0 era
Main Competences and Solutions
34
• Authoring/Publishing Topics based processes • Methodologies/Standards: DITA, IM, FD, …? • Technologies: XML, CSS, XSLT, HTML5 • Tagged Contents • Tools: CCMS/CAT • Vertical contents Task/Context driven
Skills and Tools for Tech Comm in Web 2.0 era
Tagged Contents (1/3)
35
Contents can be tagged for different aggregation goals
Admin Install
User Aggregate contents for different types of documents
Aggregate contents for different users
Aggregate contents for different channels
Make contents searchable for Web 3.0 semantyc engines Skills and Tools for Tech Comm in Web 2.0 era
Tagged Contents (2/3)
36
Cont
Cont
Cont Cont Cont
Cont
Cont Cont
Cont
Cont Cont
Cont
Cont Cont
Cont
Cont Cont
Cont
Cont
Skills and Tools for Tech Comm in Web 2.0 era
HTML Admin Install
Help On Line
Tagged Contents (3/3)
37 Skills and Tools for Tech Comm in Web 2.0 era
Example of “two levels” Tagging (Argo CMS – Kea s.r.l. source)
Tags for conditional reuse of contents (title styles for different docs) Tags for the status of a document (approved, to be completed, …)
Main Competences and Solutions
38
• Authoring/Publishing Topics based processes • Methodologies/Standards: DITA, IM, FD, …? • Technologies: XML, CSS, XSLT, HTML5 • Tagged Contents • Tools: CCMS/CAT • Vertical contents Task/Context driven
Skills and Tools for Tech Comm in Web 2.0 era
Collaborative Writing
Topics Data Base
Administration Manual
Quick Start Manual
Quality Sistem Docs
Installation Manual
White Paper
Brochure
Help on Line
Automated Templates
Multichannel & Multiplatform
Form
at &
Sty
le (C
SS)
Author 1
Author 2
Author 3
Author N
Access Profiling
Centralized Repository
Translation
CAT Tools XML-based
Authoring/Publishing basic diagram with CCMS
Skills and Tools for Tech Comm in Web 2.0 era 39
Main Competences and Solutions
40
• Authoring/Publishing Topics based processes • Methodologies/Standards: DITA, IM, FD, …? • Technologies: XML, CSS, XSLTS, HTML5 • Tagged Contents • Tools: CCMS/CAT • Vertical contents Task/Context driven
Skills and Tools for Tech Comm in Web 2.0 era
Vertical contents Task/Context driven (1/2) ONLY the information to perform my task… that is ONLY the
REALLY NEEDED information!
41 Skills and Tools for Tech Comm in Web 2.0 era
Vertical contents Task/Context driven (2/2) Minimalism can help us… The four basic principles of minimalism are: Principle 1: Choose an action-oriented approach Principle 2: Anchor the tool in the task domain Principle 3: Support error recognition and recovery Principle 4: Support reading to do, study, and locate 1 & 2 means… Task oriented 4 means… locate information quickly in the Context
42 Skills and Tools for Tech Comm in Web 2.0 era
Vertical contents example: OnLine Help(1/2) ISO/IEC 18109 Software and system engineering – Guidelines for the design and
preparation of user documentation for application software
43
Online information
Online presentation Online documentation
User assistance eLearning Manuals
OnLine Help
Skills and Tools for Tech Comm in Web 2.0 era
Vertical contents example: OnLine Help (2/2)
Information seeks the user… in the user task context!
44
The RIGHT information to the RIGHT person at the RIGHT time in the RIGHT way!
Topic based and content
reuse approach!
Skills and Tools for Tech Comm in Web 2.0 era
OLH is… an hypertext Topic based
45
Every Topic is “Topic one” and different “knowledge path” are present...
Cap. 1 Cap. 2 … Cap. n
… not like a traditional, sequential, hierarchical manual.
Skills and Tools for Tech Comm in Web 2.0 era
OLH is… browsable in different ways
46
• TOC • Index • Full-text Search
• Next/Before Topic • Links • Breadcrumbs
Skills and Tools for Tech Comm in Web 2.0 era
OLH is… Task oriented
47 Skills and Tools for Tech Comm in Web 2.0 era
Today we have spoken about…
48 Skills and Tools for Tech Comm in Web 2.0 era
Alessandro Stazi [email protected] [email protected] Blog: www.artigianodibabele.it Skype: alexandros66 Twitter: The Twriter
Thanks for your attention!
49 Skills and Tools for Tech Comm in Web 2.0 era