Give Your DITA wings with taxonomy & modern web design. Joe Pairman

Size: px

Start display at page:

Download "Give Your DITA wings with taxonomy & modern web design. Joe Pairman"

Margery Cook
6 years ago
Views:

1 Give Your DITA wings with taxonomy & modern web design Joe Pairman

2 What do we all want?

3 What do we all want? ~ Free beer

4 What do we all want? ~ Free beer ~ We want our content to be effective

5 What do we all want? ~ Free beer ~ We want our content to be effective ~ for which it needs to be found and viewed

6 Where will our content be found?

7 Where will our content be found? ~ On the web

8 Where will our content be found? ~ On the web ~ Via a search engine

9 Where will our content be found? ~ On the web ~ Via a search engine ~ One client: 80% of pageviews come from organic search

10 Where will our content be found? ~ On the web ~ Via a search engine ~ One client: 80% of pageviews come from organic search ~ From experience, this is very typical

11 Agenda ~ What are Google and other search engines looking for? ~ How does DITA meet those needs (and of course, those of users!) ~ What is DITA missing that taxonomy can bring? ~ What further markup help do search engines need (Schema.org)? ~ How do we produce that markup scalably?

12 What kind of pages do Google / other search engines rank highly? ~ Highly designed sites?

13 What kind of pages do Google / other search engines rank highly? ~ Highly designed sites? ~ Actually, mobile-friendly sites

14 What kind of pages do Google / other search engines rank highly? ~ Highly designed sites? ~ Actually, mobile-friendly sites ~ Fast-loading sites

15 What kind of pages do Google / other search engines rank highly? ~ Highly designed sites? ~ Actually, mobile-friendly sites ~ Fast-loading sites ~ Alternative pages with extremely simple HTML

16 If fancy visual design isn t important, what is?

17 If fancy visual design isn t important, what is? ~ Content itself, for a start

18 What kind of content gets ranked highly? (and found) ~ Purposeful content ~ Content that matches users intent ~ Specifically, one of four intent types: I want to know I want to go I want to do I want to buy

19 What kind of content gets ranked highly? (and found) ~ Purposeful content ~ Content that matches users intent ~ Specifically, one of four intent types: I want to know I want to go I want to do I want to buy ~ Two of these probably match what our content is aiming at

20 DITA to know; DITA to do Concept ~ Concepts provide background that helps readers understand essential information about a product, a task, a process, or any other conceptual or descriptive information. DITA 1.3 spec ~ Title and shortdesc are the narrow end of the pyramid Task ~ A task information type answers the "How do I?" question by providing precise step-by-step instructions detailing the requirements that must be fulfilled, the actions that must be performed, and the order in which the actions must be performed. DITA 1.3 spec

21 How do simple search results use DITA structures? ~ Title (main topic title + possibly the site name) ~ Snippet (often 1 st 170 chars of your shortdesc, transformed to HTML meta description)

~ For site search, link previews are just as useful Apparently no

22 Shortdesc is a very important chunk of info ~ SERP link previews tend to use it ~ It may improve ranking in the first place! ~ For site search, link previews are just as useful Apparently no shortdescs or equivalent Shortdescs (as meta description & in page content)

23 Wellstructured procedural steps are important for How do I do intent

24 Where goal-oriented DITA needs help ~ Each topic focuses on a goal ~ But how do we analyse and keep track of all user goals? ~ Enter taxonomy

25 Terminology: taxonomy ~ A way to keep track of things that are important to your organization ~ A way to keep track of names for those things ~ A way to indicate some broad relationships between those things

26 What does a taxonomy look like?

27 Taskonomy: simplifying by focusing on user tasks

28 Taskonomy*: simplifying by focusing on user tasks *Not a made-up word:

29 Taskonomy: simplifying by focusing on user tasks Top-level tasks: ~ Bridge roles, tools, and environments ~ May correspond to usage lifecycle

30 Insight deep in the hierarchy Users needed to see content related to their task

31 Insight deep in the hierarchy Users needed to see content related to their task detailed procedures but also overviews/ scenarios

32 Insight deep in the hierarchy Users needed to see content related to their task detailed procedures but also overviews/ scenarios

33 Insight deep in the hierarchy Users needed to see content related to their task detailed procedures but also overviews/ scenarios

34 Re-architecting content: a user goal or session per page / URL

35 Re-architecting content: a user goal or session per page / URL ~ Good for users ~ Good for Google ~ Good for site search/browsing

36 Focused pages reduce duplication & effort ~ From a comprehensive user guide per product

37 Focused pages reduce duplication & effort ~ From a comprehensive user guide per product ~ To a single instance of each task, reducing product-specific instructions to installs, etc.

38 Other benefits of taskonomy

39 Top-level tasks used to unify the content

42 Logic for auto related links ~ More relevant than fully automated related links Human-constructed thesaurus Human input in tagging ~ Far less creation & maintenance effort than manual links

43 The small matter of publishing to the web ~ Two approaches: dedicated DITA portal / publish directly to Web CMS ~ Pros and cons for both ~ Web CMS typically gives consistent branding / SEO, and ability to show DITA next to related marcomms content ~ But DIY is very expensive

44 AEM XML documentation add-on solves many problems

Search engines do face challenges Getting users to the right page, where there s lots of content on similar subject matter Finding useful snippets to show relevancy, where the

45 Search engines do face challenges Getting users to the right page, where there s lots of content on similar subject matter Finding useful snippets to show relevancy, where the page isn t well introduced, or where the introduction uses unfamiliar language Even finding relevant content in the first place, with specialized subject matter or different terms

46 DITA metadata + inline taxonomy can help search engines too Google s guide on structured data (extra metadata to help search engines) ~ Helps Google find relevant results (good if yours are relevant!) ~ Can enable various richer search results

47 Google search features

48 Schema.org ~ Initiative started by Bing, Google, Yahoo and later Yandex ~ to create and support a common set of schemas for structured data markup on web pages. With Schema.org, webmasters and developers can learn about structured data and improve how their sites appear in search results ~ It s rather large now

49 Schema.org ~ Initiative started by Bing, Google, Yahoo and later Yandex ~ to create and support a common set of schemas for structured data markup on web pages. With schema.org, webmasters and developers can learn about structured data and improve how their sites appear in search results ~ It s rather large now

50 Possible metadata for offer (price, etc.)

51 How to generate this markup? ~ Tools such as Schema App can help with manual entry / relationships, etc. ~ They can also integrate with e- commerce platforms such as Shopify ~ But for granular content, it s trickier

52 How about for more granular content?

53 In DITA we already classify chunks of content

54 In DITA we already classify chunks of content

55 In DITA we already classify chunks of content

56 Generating Schema.org markup automatically from DITA source

57 Author in AEM (or any integrated editor)

58 Add some simple metadata

59 Generate output from the map as normal

60 Push content to AEM publishing instance

61 Push content to AEM publishing instance

62 Published content

63 Published content

64 DITA task (specialized) > Recipe entity

65 Data elements > totaltime and recipeyield

66 List item in ingredients section > recipeingredient

67 Step in (specialized) task > recipeinstructions

68 What does Google make of this metadata?

69 Rich snippet: desktop search

70 Rich snippet: desktop search

71 Rich snippet: desktop search

72 Recipe carousel: mobile search

73 Recipe label: mobile image search

74 Summary ~ Use DITA to really shape your information to its purpose Don t just chop books up into DITA-shape objects! ~ Use taxonomy, maybe taskonomy, to define, explore, and manage user tasks ~ Tag your content with taxonomy concepts for internal and external findability ~ Publish your content to the web. (Remember that 80%!) ~ Consider Schema.org markup talk to me!

75 Questions / suggestions? ~ joepairman@mekon.com

management, and enables businesses to effectively create, deploy, and manage Internet

Public Page 1 of 11 The EchoBus CMS enables your staff to create dynamic websites by providing with extensive features for website development and content management, and enables businesses to effectively