Content Engineering & the
Internet of Smart Things
Mark Lewis
Content Engineer
@LewisDITAMetric
 Automate every stage of the
content process from creation
to consumption
 Dynamically assemble your
business-critical content
 Deliver in any format to any
channel — web, tablet,
mobile, print and more
 Reduce the content lifecycle
by up to 85%
Quark Software Inc.
Developer of Content Automation solutions for
large organizations:
Government
Intelligence, legislation,
Regulation
Other
SOPs, apps, journals,
magazines, newspapers
Industrial
Technical docs, SOPs,
marketing materials
Research reports, SOPs,
customer communications
Financial
Content Automation Innovators
Visit the Quark Booth
Receive your FREE copy!
Inside you’ll find:
• If content automation
is for you
• How to conduct a
content audit
• How to select a
content automation
platform
• Real-life success
stories
Raise awareness a big challenge /
opportunity that IoST brings…
 Define the Problem
 Definitions
 Examples of (smart) things
 Consider a Solution
 Proposal
 Homework
Goal / Agenda
Definitions
Whatis.techtarget.com says…
“The Internet of Things (IoT) is an environment in
which objects, animals or people are provided with
unique identifiers and the ability to transfer data over
a network without requiring human-to-human or
human-to-computer interaction. IoT has evolved from
the convergence of wireless technologies, micro-
electromechanical systems (MEMS) and the Internet.”
Definitions
Definitions
Gartner IT Glossary says…
“The Internet of Things (IoT) is the network of
physical objects that contain embedded technology to
communicate and sense or interact with their internal
states or the external environment.”
Jim Tully of Gartner “not just things. IoT includes a
stack of technologies”. Communication, Data Storage,
Analyzing. Remote operation of a device.
Definitions
Technopedia says…
Similar to the Gartner definition, but adds…
“The IoT is significant because an object that can
represent itself digitally becomes something greater
than the object by itself. No longer does the object
relate just to you, but is now connected to
surrounding objects and database data. When many
objects act in unison, they are known as having
‘ambient intelligence’ ”.
Definitions
And Technopedia says…
“The Internet of Things is a difficult concept to define
precisely”.
Definitions
Lots of definitions
Means lots of possibilities
API / SDK
Definitions
Definitions
Definitions
Smart products may include sensors,
microprocessors, data storage, controls,
embedded software and possibly a user
interface.
Examples
Examples
Senses Motion
Monitors Conditions
The Thinking Fan
Examples
Cars: Tesla cars
Medical Devices: Medtronic’s Glucose
Monitoring
iRobot Roomba
Phones, Fitbits, watches
Home security, home automation
..and fans.
Definitions
Definitions
Systems of Smart Products
Smart Farms
Smart Mines
Michael E. Porter and James Heppelmann. How Smart, Connected
Products are Transforming Competition. Web. Jan. 21, 2015
Systems of Smart Products
Smart Mines – Joy Global
Michael E. Porter and James Heppelmann. How Smart, Connected
Products are Transforming Competition. Web. Jan. 21, 2015
Definitions …
Definitions
GE’s 4th conference on the “Industrial Internet”
Definitions
Minds & Machines Conference
Definitions
Michael E. Porter and James Heppelmann. How Smart, Connected Products are
Transforming Competition. Web. Jan. 21, 2015
Smart Parts
Smart products made of smart parts
Jet Engines
Smart Parts
Smart products made of smart parts
…and content
Smart Parts
Smart content / Intelligent content
Lots of definitions
Lots of complexity
Forbes.com
The Problem recap
 IoT
 API / SDK content
 Smart Products
 More features – More content
 IoST
 Systems of connected Things – More content
about systems
 Systems of connected Smart Things / Products
 New Requirements, New Requirement Types
 What’s next?
The Solution
In the Product Dev Lifecycle,
Documentation
and Content are typical the lowest
priority
Content as an afterthought…will fail
No more
The Solution
Why Content Engineering?
Content is becoming more and more
complicated.
We must apply engineering principles in
order to satisfy all the new content
requirements.
Other engineering disciplines have long ago
had success with modularity and reuse.
Software Development Lifecycle
Phases
Requirements, Design, Implement, Test,
Maintenance
Software Development Lifecycle
Effort
Requirements, Design, Implement, Test,
Maintenance
© Pressman
Software Development Lifecycle
Effort
Requirements, Design, Implement, Test,
Maintenance
© Pressman
Content Development Lifecycle
Requirements, Design, Implement, Test,
Maintenance
Alignment blog:
Requirements and the
CDLC
Content Development Lifecycle
Requirements, Design, Implement, Test,
Maintenance
Content Development Lifecycle
Requirements, Design, Implement, Test,
Maintenance
Development Lifecycle
Comparison
Content Software
Same phases. Similar WBS
Development Lifecycle
Parallelism
Content
Software
Aligning the Lifecycles
Smart products are made of smart parts.
Smart parts may have software,
mechanical, electrical components …and
content. Content is another component.
We’ll need to use Smart Content /
Intelligent Content to help create smart
products. Defining content requirements
and design in parallel with the other
components to make sure they are
included in the overall definition of the part
or product.
Aligning Strategies
Aligning the Lifecycles
Aligning the Processes
Skills needed for
Smart Content /
Intelligent Content
Requirements
Design
Product Development Lifecycle
Requirements, Design, Implement, Test,
Maintenance
Alignment blog:
Real Requirements
Product Development Lifecycle
Requirements, Design, Implement, Test,
Maintenance
Alignment blog:
Understanding Objects
System, Sub-system,
Components
© David Taylor
Rockley Methodology
Components, Parts, Objects
© David Taylor
API / SDK
Objects
© David Taylor
Object Technology: A
Manager’s Guide
by David Taylor
Systems of Smart Products
Forbes.com
Systems of Smart Products
Smart Farms
Smart Mines
Michael E. Porter and James Heppelmann. How Smart, Connected
Products are Transforming Competition. Web. Jan. 21, 2015
Systems of Smart Products
Smart Mines
Michael E. Porter and James Heppelmann. How Smart, Connected
Products are Transforming Competition. Web. Jan. 21, 2015
Intelligent Content
Definition:
Structurally-rich and semantically
categorized content that is, therefore,
automatically discoverable, reusable,
reconfigurable, and adaptable.
© Rockley
Fan
#Asstronomical
Who’s talking about it…
Who’s talking about it…
Creating Smart Documentation and the Future of
Technical Writing (BrightTalk)
By Alexander Hoffman
Working with other disciplines
and lifecycles
Get involved in phases of other lifecycles
API/SDK
Using these skills to improve
Executives
Get comfortable
Join the
Alignment Community
Raise Awareness
Homework
 Read Mark’s LinkedIn Blog
 Real Requirements
 Requirements and the Content Dev
Lifecycle
 Understanding Objects
 Gain the skills
Thank You
Visit the Quark Booth
Receive your FREE copy!
Inside you’ll find:
• If content automation
is for you
• How to conduct a
content audit
• How to select a
content automation
platform
• Real-life success
stories
#Asstounding
More great sessions in this room
Kevin Nichols Cruce Saunders

Content Engineering and The Internet of “Smart” Things with Mark Lewis

Editor's Notes

  • #3 Digital publishing solutions that cover the entire content lifecycle. XML authoring in Word in a browser. The Quark Platform CMS. High fidelity multi-channel publishing to PDF, the web, mobile devices. The entire content lifecycle. Stop by the Quark booth to get a free copy of Dummies book. Quark develops content automation software for large global organizations.   There’s a huge volume of business-critical content in the world Organizations still typically create ALL content manually This is extremely difficult to manage, expensive and very slow The processes have remained largely unchanged for decades Quark provides software to automate the content process from creation to consumption    How do we do this? Rather than creating documents, our customers create reusable Smart Content components These reusable Smart Content components only have to get created once, reviewed and approved once, and then they are dynamically assembled into different documents for the Web, PDFs, even to mobile apps Because our content automation software is tracking all of these content components, if a change is made to any of the content, it can automatically update every document and occurrence where that content is used
  • #4 We sell to organizations across a range of industries including finance, government, industrial and life sciences. This is just a sampling of customers but hopefully gives you some sense of the size and complexity of clients that we work with. If you have time, you can use one or more of the following brief examples to illustrate what we do: HSBC HSBC uses our content automation platform across a large number of projects including investment research reporting, their global standards manual and call center customer service procedures They have a return on investment in the range of millions of dollars/euros/pounds through efficiency savings, reduced time to market and improved compliance UNICEF UNICEF runs their entire donor information system using our content automation platform They reduced the time it takes to create personalized donor communications from weeks to seconds and directly attribute an increase in their donations of half a billion dollars annually to their new donor system Emirates Airlines Emirates uses our content automation platform to deliver information to their cabin crew and ground staff They have been able to minimize the downtime of their aircraft, improve the training of 4,000 staff per year, enable a mobile workforce of 17,000 and improve customer service
  • #6 Goal is to raise awareness about a big challenge / opportunity
  • #7 I’ve found many definitions for IoT and what I don’t want to do is have a heated debate about the what is the most accurate def.
  • #11 Hold that thought. Apparently so.
  • #12 I’ve found many definitions for IoT and what I don’t want to do is have a heated debate about the what is the most accurate def.
  • #13 For this discussion, things equals products.
  • #21 Caterpillar 30%
  • #22 Relate this to a SYSTEM…Star system…an increase in complexity and volume of content……
  • #27 I think
  • #28 Add individual Content Sphere TODO
  • #30 Star system…an increase in complexity and volume of content…….System
  • #32 It’s getting better, but you know what I am talking about.
  • #33 This track is called content engineering…let’s take a look
  • #34 Software is one component of a smart product.
  • #35 An interesting …I’ve simplified this a bit for this conversation
  • #37 Homework
  • #39 Designing content models, content structure reuse maps.
  • #40 It’s the same phases. A similar WBS
  • #41 I’ve always thought this was an interesting parallelism and part of the solution to “the problem”.
  • #42 Aligning lifecycles. Aligning processes. No more Content as an afterthought
  • #44 How do we do this? If you are not comfortable working with reqs documentation and design documentation, I encourage you to gain these skills.
  • #45 In my blog, CLEAR UNAMBIUOUS. You may think you know to write reqs, but I seen them written as a combo of reqs and design, so I recommend you take a class or a workshop on writing requirements. It’s been many years since I did this so I don’t know who to recommend. If you do please add it in a comment to the blog.
  • #46 Similarly, I’ve posted my STC presentation. It will help you break down systems into sub-systems and components.
  • #47 BODY. I use this skill to understanding technology……This is why I’ve shared my presentation on learning OOD. As a content strategist, I use the Rockley Methodology. Understanding OOD really helped me learn and use this methodology.
  • #48 This will help you if you are writing API / SDK content.
  • #49 Most of the presentation is based on this book.
  • #50 Relate this to a SYSTEM…Star system…an increase in complexity and volume of functionality …and content……
  • #51 Relate this to a SYSTEM…Star system…an increase in complexity and volume of content……
  • #52 Relate this to a SYSTEM…Star system…an increase in complexity and volume of content……
  • #53 If you haven’t read the definition of IC. Part of the solution is learning and using this methodology.
  • #55 I am I thinking about this correctly?
  • #57 As you become comfortable with requirements documents and design documents, you can help and collaborate with the documents of the other disciplines.