Adobe Day UK 2013: Seek and ye shall find

•

0 likes•363 views

A look at how you can improve your help file's searchability by using existing help application functionality and a handful of third party applications.

Technology Design

Colum McAndrew
RoboColum(n) Consulting
Seek and ye shall find:
Improving your help system's search results
Adobe Day at UA Europe Conference
Manchester, UK
12 June 2013

Slide 2 © RoboColum(n) Consulting 2013
Or to put it another way…

Slide 3 © RoboColum(n) Consulting 2013
“I still haven’t found what I’m looking for”
83rd
result!
24th
result!

Slide 4 © RoboColum(n) Consulting 2013
The Google guide to searching

Slide 5 © RoboColum(n) Consulting 2013
Things to consider
 Help type
 Content structure
 SEO (web based)
 Synonyms
 Metadata
◦ Index
◦ Topic
 Stop words

Slide 6 © RoboColum(n) Consulting 2013
Help output characteristics
 Search differs by the
output type.
 Authoring tools use
different algorithms.
 Same applies to
search engines.

Slide 7 © RoboColum(n) Consulting 2013
Content structure: Adobe RoboHelp
 Topic title
 Topic keywords
 Heading styles
 Topic text
 Index keywords
Question:
What elements affect how a topic is
displayed in the search rankings?
There are
five in total

Slide 8 © RoboColum(n) Consulting 2013
Content structure: Madcap Flare
 Topic title
 Heading styles
 Topic text

Slide 9 © RoboColum(n) Consulting 2013
Online Search Engine Optimisation
Willam van Weelden’s
webinar:
“Optimizing your RoboHelp
content for best SEO
results”
http://adobe.ly/Pbdp0J
 URL
 Topic title
 Keyword positioning

Slide 10 © RoboColum(n) Consulting 2013
Synonyms
Useful for:
 Localisation
e.g. UK v US English
 Typographical errors
e.g. Mispell v Misspell
 Verbiage
e.g. Adding v Creating

Slide 11 © RoboColum(n) Consulting 2013
Metadata

Slide 12 © RoboColum(n) Consulting 2013
Uses for metadata
Useful for:
 Overview topics
 Video
 3D images
 Sample files

Slide 13 © RoboColum(n) Consulting 2013
Stop words
 Don’t trust your stop
word list.
 Amend it if you can.
 Look out for:
◦ Formula (boolean)
logic.
◦ Nouns / Adjectives

Slide 14 © RoboColum(n) Consulting 2013
Wrensoft Zoom
http://www.wrensoft.com/zoom/index.html
http://www.grainge.org/pages/authoring/zoomsearch/zoomsearch.htm

Slide 15 © RoboColum(n) Consulting 2013
Yay! I found it.

Slide 17 © RoboColum(n) Consulting 2013
Take Away Tips
Think about the different elements of a topic. Ask
yourself the following questions:
• Does the Topic Title accurately describe the
content.
• What is the one word that you’d expect to see
more than any other in the topic?
• Could the use of different heading styles or topic
metadata ensure a topic is more accurately
indexed?

Slide 18 © RoboColum(n) Consulting 2013
Educate your users
 Fact 1:
People think they know how to
search.
 Fact 2:
Search tools do not all work the
same way.
 Fact 3:
If users can’t find what they want,
they go elsewhere.

Slide 19 © RoboColum(n) Consulting 2013
The Darwin Award for searching goes to…

Slide 20 © RoboColum(n) Consulting 2013
Contact the RoboColum(n)
@robocolumn
robocolumn@cmcandrew.com
http://uk.linkedin.com/in/notcolin
www.cmcandrew.com
www.robocolumn.com

Alan Shalloway takes you beyond thinking of design patterns as “solutions to a problem in a context.” Patterns are really about handling variations in your problem domain while keeping code from becoming complex and difficult to maintain as the system evolves. Alan begins by describing the classic use of patterns. He shows how design patterns implement good coding practices and then explains key design patterns including Strategy, Bridge, Adapter, Façade, and Abstract Factory. In small group exercises, learn how to use patterns to create robust architectures that can readily adapt as new requirements arise. Lessons from these patterns are used to illustrate how to do domain analysis based on abstracting out commonalities in a problem domain and identifying particular variations that must be implemented. Leave with a working understanding of what design patterns are and a better way to build models of your application domains.

Swf search final

Duane Nickull

Flash SEO Secrets

rtretola

Monster JavaScript Course - 50+ projects and applications

Laurence Svekis ✔

Get this Course https://www.udemy.com/javascript-course-projects/?couponCode=SLIDESHARE Portfolio builder loaded with projects and applications that you can use, extend on and enhance to add to your portfolio JUST GOT BIGGER - more updates to come - YOU FOUND IT Grow your portfolio - showcase what you can build with JavaScript Learn JavaScript have fun with interactive and dynamic web applications. Over 529 downloadable resources - 57 articles - 43+ hours on-demand video, 57 Sections Over 614 HD video lessons Over 51+ projects and web applications. Projects can be used as started projects to extend and enhance. All JavaScript focused. 4 downloadable ebook guides 200 pages and 3 x 60 pages - with code and resource links No libraries JUST JAVASCRIPT and JAVASCRIPT DOM This is the course you've been looking for.......... Everything you need to get started with JavaScript, expand your knowledge about using JavaScript, and more included. It’s arrived, and bigger than expected!!! For anyone who wants to supercharge their JavaScript learning - building and applying JavaScript to over 50 projects and challenges… this course is for YOU!!!! From JavaScript beginners to all levels, course is presented in a fun interactive format that will challenge you. Move through the lessons of the course as you want to learn them, variety of ways to benefit from it. Learn alongside, try before you see the solution, try after you view the solution. It’s up to you! Unique format for learning encouraging you to try the code. Of course source code is included in every step of the way. Most often asked for ARE PROJECTS - and this course delivers! Over 50 and will grow over time as more projects and challenges get added. You can select the projects you want to do or take them in order, it’s up to you. Loaded with games and so many mini projects guaranteed to help you learn more about JavaScript and DOM manipulation. All JavaScript code no libraries or short cuts. Explore how to apply JavaScript to create interactive and dynamic web content - that will impress your friends. Extend on the projects and add them to your portfolio, to showcase skills you have learned. Useful real world projects coded with simple JavaScript for developers of all levels. No better way to learn than to try the code and produce something fun and useful with it. Learn to create amazing things with JavaScript bringing your web content to life. This will keep you busy and provide you the opportunity to learn and experiment with code. Try it. All the projects are designed in a starter type format so that you can build on them and customize to make it your own. Portfolio Builder 50+ projects This course includes full introduction to coding with JavaScript, all core syntax and how to apply it to make things happen. Create your own code - loaded with challenges and code snippets.

Front-End Modernization for Mortals

cgack

There are tons of awesome new tools produced by terrific companies and developers that get everyone excited about using their fancy new tool-set by essentially starting from scratch. This talk is not about using a fancy new framework and rewriting your entire application. As a developer who has spent the majority of his time working in legacy codebases where the first commits pre-date jQuery, it's hard not to get wrapped up in the "I want to rewrite the whole app with X" mentality. But in reality, time constraints or just the legacy framework you're building your apps with doesn't allow for that. Or, more realistically, it just needs to work and there is no business case for a rewrite. What this talk will show you how you can still enhance your front-end operation within an existing legacy codebase. I'll talk about first steps to modularizing a monolith, or simply taking a portion of a legacy app and modernizing it with a new toolset. This not only helps you as a developer to succeed with new tools, it makes you feel like you aren't being left behind in the modern world. Whether you're using legacy jQuery, or just some crammed together JavaScript, you shouldn't lose the ability to modernize your application, just because you can't buy in 100% to a modern framework. Tips on how to break apart your monolithic JavaScript Building an extension method to modularize your application Creating backcompat methods for legacy code modernization Using a modern framework for a portion of your app, and integrating that with your existing code. Other considerations (minification, module loaders, tests, etc)

Front end-modernization

ColdFusionConference

Front end-modernization

devObjective

Golang, Python or C/C++, who wins

Obed N Muñoz

This time I had an opportunity for presenting at Ameca, Jalisco. I presented at the CUVALLES university. My talk was about some of the key features of Golang, Python and C/C++ programming languages. But, this was not the main reason I choose this topic. The idea is to explain the process for choosing a good programming language for your project. It’s not about the language, it’s about the problem you want to solve and which are the features a programming language can offer you to solve the problem.

Theme customisation for beginners

Gareth J Barnard

Seven elements of technical Agility - Gil Broza - Agile Israel 2013AgileSparks

Drupalusability

ultimateboy

Collaborativet Tools

tstephens

Theme development workshop part 2

Bas Brands

Top Object-Oriented Programming Languages To Follow In December 2022.pdf

JamesEddie2

Collaborative Toolststephens

Collaborativet Tools

tstephens

Collaborativet Toolststephens

みなさんこんにちはこれ何文字まで入るの？40文字以下不可とか本当に意味わからないけどこれ限界文字数書いてないからマジでやばい文字数いけるんじゃないの？えこ...

名前です男

Observability Concepts EVERY Developer Should Know -- DeveloperWeek Europe.pdf

Paige Cruz

Monitoring and observability aren’t traditionally found in software curriculums and many of us cobble this knowledge together from whatever vendor or ecosystem we were first introduced to and whatever is a part of your current company’s observability stack. While the dev and ops silo continues to crumble….many organizations still relegate monitoring & observability as the purview of ops, infra and SRE teams. This is a mistake - achieving a highly observable system requires collaboration up and down the stack. I, a former op, would like to extend an invitation to all application developers to join the observability party will share these foundational concepts to build on:

Similar to Adobe Day UK 2013: Seek and ye shall find

Code refactoring

Long Nguyen

Optimizing Browser Rendering

michael.labriola

Upwork time log and difficulty 20160523

Sharon Liu

Design Patterns Explained: From Analysis through Implementation

TechWell

Swf search final

Duane Nickull

Flash SEO Secrets

rtretola

Monster JavaScript Course - 50+ projects and applications

Laurence Svekis ✔

Front-End Modernization for Mortals

cgack

Front end-modernization

ColdFusionConference

Front end-modernization

devObjective

Golang, Python or C/C++, who wins

Obed N Muñoz

Theme customisation for beginners

Gareth J Barnard

Seven elements of technical Agility - Gil Broza - Agile Israel 2013AgileSparks

Drupalusability

ultimateboy

Collaborativet Tools

tstephens

Theme development workshop part 2

Bas Brands

Top Object-Oriented Programming Languages To Follow In December 2022.pdf

JamesEddie2

Collaborative Toolststephens

Collaborativet Tools

tstephens

Collaborativet Toolststephens

Similar to Adobe Day UK 2013: Seek and ye shall find (20)

Code refactoring

Optimizing Browser Rendering

Upwork time log and difficulty 20160523

Design Patterns Explained: From Analysis through Implementation

Swf search final

Flash SEO Secrets

Monster JavaScript Course - 50+ projects and applications

Front-End Modernization for Mortals

Front end-modernization

Golang, Python or C/C++, who wins

Theme customisation for beginners

Seven elements of technical Agility - Gil Broza - Agile Israel 2013

Drupalusability

Collaborativet Tools

Theme development workshop part 2

Top Object-Oriented Programming Languages To Follow In December 2022.pdf

Collaborative Tools

Collaborativet Tools

Recently uploaded

名前です男

Observability Concepts EVERY Developer Should Know -- DeveloperWeek Europe.pdf

Paige Cruz

Removing Uninteresting Bytes in Software Fuzzing

Aftab Hussain

Imagine a world where software fuzzing, the process of mutating bytes in test seeds to uncover hidden and erroneous program behaviors, becomes faster and more effective. A lot depends on the initial seeds, which can significantly dictate the trajectory of a fuzzing campaign, particularly in terms of how long it takes to uncover interesting behaviour in your code. We introduce DIAR, a technique designed to speedup fuzzing campaigns by pinpointing and eliminating those uninteresting bytes in the seeds. Picture this: instead of wasting valuable resources on meaningless mutations in large, bloated seeds, DIAR removes the unnecessary bytes, streamlining the entire process. In this work, we equipped AFL, a popular fuzzer, with DIAR and examined two critical Linux libraries -- Libxml's xmllint, a tool for parsing xml documents, and Binutil's readelf, an essential debugging and security analysis command-line tool used to display detailed information about ELF (Executable and Linkable Format). Our preliminary results show that AFL+DIAR does not only discover new paths more quickly but also achieves higher coverage overall. This work thus showcases how starting with lean and optimized seeds can lead to faster, more comprehensive fuzzing campaigns -- and DIAR helps you find such seeds. - These are slides of the talk given at IEEE International Conference on Software Testing Verification and Validation Workshop, ICSTW 2022.

GraphSummit Singapore | The Future of Agility: Supercharging Digital Transfor...

Neo4j

Leonard Jayamohan, Partner & Generative AI Lead, Deloitte This keynote will reveal how Deloitte leverages Neo4j’s graph power for groundbreaking digital twin solutions, achieving a staggering 100x performance boost. Discover the essential role knowledge graphs play in successful generative AI implementations. Plus, get an exclusive look at an innovative Neo4j + Generative AI solution Deloitte is developing in-house.

National Security Agency - NSA mobile device best practices

Quotidiano Piemontese

GraphSummit Singapore | The Art of the Possible with Graph - Q2 2024

Neo4j

The Art of the Pitch: WordPress Relationships and Sales

Laura Byrne

Clients don’t know what they don’t know. What web solutions are right for them? How does WordPress come into the picture? How do you make sure you understand scope and timeline? What do you do if sometime changes? All these questions and more will be explored as we talk about matching clients’ needs with what your agency offers without pulling teeth or pulling your hair out. Practical tips, and strategies for successful relationship building that leads to closing the deal.

FIDO Alliance Osaka Seminar: The WebAuthn API and Discoverable Credentials.pdf

FIDO Alliance

PCI PIN Basics Webinar from the Controlcase Team

ControlCase

Goodbye Windows 11: Make Way for Nitrux Linux 3.5.0!

SOFTTECHHUB

As the digital landscape continually evolves, operating systems play a critical role in shaping user experiences and productivity. The launch of Nitrux Linux 3.5.0 marks a significant milestone, offering a robust alternative to traditional systems such as Windows 11. This article delves into the essence of Nitrux Linux 3.5.0, exploring its unique features, advantages, and how it stands as a compelling choice for both casual users and tech enthusiasts.

GraphSummit Singapore | Enhancing Changi Airport Group's Passenger Experience...

Neo4j

Dr. Sean Tan, Head of Data Science, Changi Airport Group Discover how Changi Airport Group (CAG) leverages graph technologies and generative AI to revolutionize their search capabilities. This session delves into the unique search needs of CAG’s diverse passengers and customers, showcasing how graph data structures enhance the accuracy and relevance of AI-generated search results, mitigating the risk of “hallucinations” and improving the overall customer journey.

GridMate - End to end testing is a critical piece to ensure quality and avoid...

ThomasParaiso2

Pushing the limits of ePRTC: 100ns holdover for 100 days

Adtran

UiPath Test Automation using UiPath Test Suite series, part 6

DianaGray10

Welcome to UiPath Test Automation using UiPath Test Suite series part 6. In this session, we will cover Test Automation with generative AI and Open AI. UiPath Test Automation with generative AI and Open AI webinar offers an in-depth exploration of leveraging cutting-edge technologies for test automation within the UiPath platform. Attendees will delve into the integration of generative AI, a test automation solution, with Open AI advanced natural language processing capabilities. Throughout the session, participants will discover how this synergy empowers testers to automate repetitive tasks, enhance testing accuracy, and expedite the software testing life cycle. Topics covered include the seamless integration process, practical use cases, and the benefits of harnessing AI-driven automation for UiPath testing initiatives. By attending this webinar, testers, and automation professionals can gain valuable insights into harnessing the power of AI to optimize their test automation workflows within the UiPath ecosystem, ultimately driving efficiency and quality in software development processes. What will you get from this session? 1. Insights into integrating generative AI. 2. Understanding how this integration enhances test automation within the UiPath platform 3. Practical demonstrations 4. Exploration of real-world use cases illustrating the benefits of AI-driven test automation for UiPath Topics covered: What is generative AI Test Automation with generative AI and Open AI. UiPath integration with generative AI Speaker: Deepak Rai, Automation Practice Lead, Boundaryless Group and UiPath MVP

Free Complete Python - A step towards Data Science

RinaMondal9

Securing your Kubernetes cluster_ a step-by-step guide to success !

KatiaHIMEUR1

Today, after several years of existence, an extremely active community and an ultra-dynamic ecosystem, Kubernetes has established itself as the de facto standard in container orchestration. Thanks to a wide range of managed services, it has never been so easy to set up a ready-to-use Kubernetes cluster. However, this ease of use means that the subject of security in Kubernetes is often left for later, or even neglected. This exposes companies to significant risks. In this talk, I'll show you step-by-step how to secure your Kubernetes cluster for greater peace of mind and reliability.

Video Streaming: Then, Now, and in the Future

Alpen-Adria-Universität

In his public lecture, Christian Timmerer provides insights into the fascinating history of video streaming, starting from its humble beginnings before YouTube to the groundbreaking technologies that now dominate platforms like Netflix and ORF ON. Timmerer also presents provocative contributions of his own that have significantly influenced the industry. He concludes by looking at future challenges and invites the audience to join in a discussion.

Epistemic Interaction - tuning interfaces to provide information for AI support

Alan Dix

Paper presented at SYNERGY workshop at AVI 2024, Genoa, Italy. 3rd June 2024 https://alandix.com/academic/papers/synergy2024-epistemic/ As machine learning integrates deeper into human-computer interactions, the concept of epistemic interaction emerges, aiming to refine these interactions to enhance system adaptability. This approach encourages minor, intentional adjustments in user behaviour to enrich the data available for system learning. This paper introduces epistemic interaction within the context of human-system communication, illustrating how deliberate interaction design can improve system understanding and adaptation. Through concrete examples, we demonstrate the potential of epistemic interaction to significantly advance human-computer interaction by leveraging intuitive human communication strategies to inform system design and functionality, offering a novel pathway for enriching user-system engagements.

Elizabeth Buie - Older adults: Are we really designing for our future selves?

Nexer Digital

20240605 QFM017 Machine Intelligence Reading List May 2024

Matthew Sinclair

Recently uploaded (20)

Observability Concepts EVERY Developer Should Know -- DeveloperWeek Europe.pdf

Removing Uninteresting Bytes in Software Fuzzing

GraphSummit Singapore | The Future of Agility: Supercharging Digital Transfor...

National Security Agency - NSA mobile device best practices

GraphSummit Singapore | The Art of the Possible with Graph - Q2 2024

The Art of the Pitch: WordPress Relationships and Sales

FIDO Alliance Osaka Seminar: The WebAuthn API and Discoverable Credentials.pdf

PCI PIN Basics Webinar from the Controlcase Team

Goodbye Windows 11: Make Way for Nitrux Linux 3.5.0!

GraphSummit Singapore | Enhancing Changi Airport Group's Passenger Experience...

GridMate - End to end testing is a critical piece to ensure quality and avoid...

Pushing the limits of ePRTC: 100ns holdover for 100 days

UiPath Test Automation using UiPath Test Suite series, part 6

Free Complete Python - A step towards Data Science

Securing your Kubernetes cluster_ a step-by-step guide to success !

Video Streaming: Then, Now, and in the Future

Epistemic Interaction - tuning interfaces to provide information for AI support

Elizabeth Buie - Older adults: Are we really designing for our future selves?

20240605 QFM017 Machine Intelligence Reading List May 2024

Adobe Day UK 2013: Seek and ye shall find

1. Colum McAndrew RoboColum(n) Consulting Seek and ye shall find: Improving your help system's search results Adobe Day at UA Europe Conference Manchester, UK 12 June 2013

5. Slide 5 © RoboColum(n) Consulting 2013 Things to consider  Help type  Content structure  SEO (web based)  Synonyms  Metadata ◦ Index ◦ Topic  Stop words

6. Slide 6 © RoboColum(n) Consulting 2013 Help output characteristics  Search differs by the output type.  Authoring tools use different algorithms.  Same applies to search engines.

7. Slide 7 © RoboColum(n) Consulting 2013 Content structure: Adobe RoboHelp  Topic title  Topic keywords  Heading styles  Topic text  Index keywords Question: What elements affect how a topic is displayed in the search rankings? There are five in total

9. Slide 9 © RoboColum(n) Consulting 2013 Online Search Engine Optimisation Willam van Weelden’s webinar: “Optimizing your RoboHelp content for best SEO results” http://adobe.ly/Pbdp0J  URL  Topic title  Keyword positioning

10. Slide 10 © RoboColum(n) Consulting 2013 Synonyms Useful for:  Localisation e.g. UK v US English  Typographical errors e.g. Mispell v Misspell  Verbiage e.g. Adding v Creating

12. Slide 12 © RoboColum(n) Consulting 2013 Uses for metadata Useful for:  Overview topics  Video  3D images  Sample files

13. Slide 13 © RoboColum(n) Consulting 2013 Stop words  Don’t trust your stop word list.  Amend it if you can.  Look out for: ◦ Formula (boolean) logic. ◦ Nouns / Adjectives

14. Slide 14 © RoboColum(n) Consulting 2013 Wrensoft Zoom http://www.wrensoft.com/zoom/index.html http://www.grainge.org/pages/authoring/zoomsearch/zoomsearch.htm

16. Slide 16 © RoboColum(n) Consulting 2013 Using Wrensoft Zoom  A few additional files must be included with the output.  These include two that are editable:  Basic search template that you “brand”.  Search template display settings.  BEWARE! By default these files are overwritten each time the output is generated / published.  ZoomSearch only works with web based output.

17. Slide 17 © RoboColum(n) Consulting 2013 Take Away Tips Think about the different elements of a topic. Ask yourself the following questions: • Does the Topic Title accurately describe the content. • What is the one word that you’d expect to see more than any other in the topic? • Could the use of different heading styles or topic metadata ensure a topic is more accurately indexed?

18. Slide 18 © RoboColum(n) Consulting 2013 Educate your users  Fact 1: People think they know how to search.  Fact 2: Search tools do not all work the same way.  Fact 3: If users can’t find what they want, they go elsewhere.

20. Slide 20 © RoboColum(n) Consulting 2013 Contact the RoboColum(n) @robocolumn robocolumn@cmcandrew.com http://uk.linkedin.com/in/notcolin www.cmcandrew.com www.robocolumn.com

Adobe Day UK 2013: Seek and ye shall find

Recommended

Recommended

More Related Content

Similar to Adobe Day UK 2013: Seek and ye shall find

Similar to Adobe Day UK 2013: Seek and ye shall find (20)

Recently uploaded

Recently uploaded (20)

Adobe Day UK 2013: Seek and ye shall find