65
Matthew Ellison UA Europe Getting Started with Micro Content Authoring in MadCap Flare 2019

Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

  • Upload
    others

  • View
    2

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Matthew EllisonUA Europe

Getting Started with Micro Content Authoring in MadCap Flare 2019

Page 2: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Agenda

What is Micro Content? What can I use it for? How can I create Micro Content in

Flare 2019? How can I use Micro Content to

improve Search? How can I use Micro Content outside

of Flare?

Page 3: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

"Micro Content"

Term originally coined by Web usability guruJakob Nielsen

Page 4: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

"Micro Content"

Nielsen's current definition:

"a type of UX copywriting in the form of short text fragments or phrases, often presented with no additional contextual support.Microcontent usually communicates key messages in a concise form:"

Microcontent: A Few Small Words Have a Mega Impact on BusinessHoa Loranger and Jakob Nielsen, January 29, 2017

Page 5: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Nielsen's examples of micro content:

Page titles Page headings (headlines) Taglines Email subject lines Summaries, decks Hints, tips, explainers

Page 6: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

My preferred definition of Micro Content

"a way of providing quick answers to questions"

Page 7: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Another great definition…

[ https://www.brafton.com/blog/creation/microcontent-what-is-it-and-why-do-you-need-it/ ]

Page 8: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Key potential uses for Micro Content in UA

Outside of FlareSource content for:• Chatbots• FAQs• Virtual Reality (VR) Applications• Embedded Field-level Help

Within Flare• "Featured Snippets"

Page 9: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Chatbot

Question or Phrase

Response

Page 10: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

FAQs - Phrase

Page 11: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

FAQ - Response

Rich content including

video

Page 12: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Virtual and Augmented Reality

Page 13: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Field-level Help

Page 14: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Why use Flare to create this Micro Content?

Single-sourcing:Re-use Micro Content within Flare's regular "long-form" topics

Rich Content Authoring:Styles, lists, tables, images, multimedia, variables, responsive layout, etc.

Page 15: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Using Micro Content within Flare

A very interesting and exciting new opportunity to improve Search Results

Based on the concept of"Featured Snippets"(a term invented and used by Google)

Page 16: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Some Background on Google's Micro Content

May 16, 2012Google announces Knowledge Graph

A move from full-text search to more relevant and meaningful results based on an understanding of concepts and relationships

October 2016Knowledge Graph holds > 70 billion facts

Page 17: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Featured Snippet

A summary of an answer to a user’s query, displayed at "position zero"

Page 18: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Featured Snippet

https://support.google.com/webmasters/answer/6229325

Page 19: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Three types of Featured Snippet

Paragraph (82%)

List (10.8%)

Table (7.3%)[Source: STAT Search Analytics]

Page 20: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Some examples of Google's Featured Snippets…

Page 21: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 22: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 23: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 24: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 25: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 26: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 27: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 28: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Wording is critical…

Page 29: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 30: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 31: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 32: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Evolution of Micro Content…

Page 33: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 34: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Nano Content?

Page 35: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Knowledge Panel

Page 36: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 37: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph
Page 38: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Key principal of Google's Micro Content…

Page 39: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

All Micro Content is re-used from existing long-form content on the Web

Page 40: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Google says:

"When we recognize that a query asks a question, we programmatically detect pages that answer the user's question, and display a top result as a featured snippet in the search results"

The featured snippet includes the page’s title and URL

Page 41: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Creating and usingMicro Content in Flare

Page 42: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Main steps for working with Micro Content

1. Create one or more Micro Content files2. Add Phrases and Responses in the

Micro Content Editor• You can add Micro Content from the

XML (Topic) Editor3. Format the Micro Content Result in the

Skin4. Include Micro Content Results in the

Target

Page 43: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Create a Micro Content file

Page 44: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Add a Phrase

Page 45: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Optional (but strongly encouraged):Add Alternative Phrase(s)

Page 46: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Optional (but strongly encouraged):Add Alternative Phrase(s)

Page 47: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Four ways to create Response

Create/edit dedicated contentin Micro Content Editor

Link to existing Topic or Snippet

Link to Bookmark withinexisting Topic or Snippet

Link to defined extract withinexisting Topic or Snippet

Not within the spirit of

Google's Featured Snippets

My preferred method

Create Phrase from XML Editor

Page 48: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Create Response in Micro Content Editor

No Text Editor tab

Page 49: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Link Phrase to a topic or snippet

Can optionally select a Bookmark

Page 50: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Link Phrase to a topic or snippet

Not within the spirit of

Google's Featured Snippets

Page 51: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

My preferred method for creating Phrases and

Responses…

Page 52: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Create Micro Content from topic or snippet

Page 53: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Result

Page 54: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

After adding Alternative Phrases

Page 55: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Format the Micro Content Result

New styles for Micro Content in Skin Editor

Page 56: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Include Micro Content Results

New Micro Content option in Target

Editor

Page 57: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Using Micro Content outside of Flare

Each Phrase-Response combination is stored as an XHTML file within Output

Page 58: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Micro Content output file

Page 59: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

How MadCap is currently using Micro Content…

Page 60: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

MadCap's current use of Micro Content

Only for Featured Snippets Three types:

• Quick Steps• Mini Landing Pages• Related Questions

Dedicated Snippets used exclusively for Micro Content Extensive use of Multimedia and

images within Responsive Layouts

Page 61: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Quick Steps

Page 62: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Mini Landing Page

Page 63: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Related Questions

Page 64: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Summary

Micro Content is a key new feature Its main application in Flare is

"Featured Snippets" that improve Search Results Follow Google's approach by re-using

long-form content Use Analytics to guide your choice of

Phrases Micro Content can also be used

outside of Flare for FAQs and chatbots

Page 65: Getting Started with Micro Content Authoring in MadCap ... · Rich Content Authoring: Styles, lists, tables, images, multimedia, ... May 16, 2012 Google announces Knowledge Graph

Matthew EllisonUA Europe

Thanks for joining!Final questions?

[email protected]