{"id":4659,"date":"2020-12-18T09:23:10","date_gmt":"2020-12-18T08:23:10","guid":{"rendered":"https:\/\/www-beta.easydoccontents.com\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/"},"modified":"2022-02-14T13:53:27","modified_gmt":"2022-02-14T12:53:27","slug":"improve-user-experience-embed-faq-in-software","status":"publish","type":"post","link":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/","title":{"rendered":"Improve User Experience: Embed FAQ in Software"},"content":{"rendered":"

Imagine your users accessing FAQ for your software product right inside the interface. No more searching online documentation for answers to frequently asked questions. For those questions that are so common, shouldn’t they be easy to find?<\/p>\n

You improve the user experience when you embed FAQ in software.<\/p>\n

Embed FAQ in Twitter<\/em><\/h2>\n

Let’s use a popular online and application software as an example of how you can embed FAQ in software. We’ll give Twitter<\/em> a facelift. (Don’t worry, we won’t hack Twitter<\/em>. We’ll use some screenshots to show a published result).<\/p>\n

First, take a look at the Twitter<\/em> FAQ page. It’s nice. Simple. Easy to read. Well organized. But users still have to leave Twitter to search for this page.<\/p>\n

\"\"<\/h2>\n

Imagine if Twitter<\/em> users could click a help icon and get a response to a question asked frequently by new users: What is the difference between a reply<\/em> and a direct message<\/em>?<\/p>\n

\"\"<\/h2>\n

Now that’s a nice user experience.<\/p>\n

Make a plan before you embed FAQ<\/h2>\n

When you embed FAQ in software it does require careful planning. You don’t want a cluttered UI. You’ll need to decide which questions are appropriate for the UI. You can always link to further documentation within the embedded FAQ.<\/p>\n

And of course, software developers and content creators (and product owners) will need to work together. Someone writes the FAQ, someone decides where to place it in the UI, and the developer makes it happen.<\/p>\n

That’s where edc<\/strong> <\/em>comes in. Easydoccontents (edc) was designed for embedded and online help and collaboration.<\/p>\n

Let’s take a look at our Twitter<\/em> example to see exactly how it works.<\/p>\n

Embed FAQ as a Brick<\/h2>\n

A brick is just a piece of UI where you want the information to live. In edc<\/strong><\/em>, you add bricks for Contextualised UI Help and use other Document Types for online help. When you embed FAQ, you can then link to related articles in the online help. This gives users the option to learn more about the subject.<\/p>\n

Using edc<\/strong><\/em>, you can embed FAQ in less time than it takes you to read this article.<\/p>\n

1. Create a brick<\/h3>\n

In the edc<\/strong> <\/em>editor, create a brick for Contextualised UI Help.<\/p>\n

\"\"<\/p>\n

2. Add a title<\/h3>\n

Add a title for the new brick. This title will appear in the UI, so make it good. When you embed FAQ, this title should be the question users ask.<\/p>\n

3. Write the description<\/h3>\n

Add the response in the Description field. This appears in the UI as the answer to the question in the title field.<\/p>\n

\"\"<\/p>\n

4. Select a brick type<\/h3>\n

Under Brick Elements, select a Brick Type. This can be a panel that opens in the software, a new window, or a tooltip.<\/p>\n

You’ll find other options under this pull-down menu. For our Twitter<\/em> example, we’ll use a panel.<\/p>\n

5. Add brick keys<\/h3>\n

Brick Keys tell the software where to place the brick in the UI. Usually, the developer includes an associated icon, such as a Help icon.<\/p>\n

A developer can create the brick and add the keys, or a writer can ask for the keys and add them directly.<\/p>\n

\"\"<\/p>\n

6. Upload a reference image (optional)<\/h3>\n

You can even upload an image, just for reference, to show how and where the FAQ should appear.<\/p>\n

\"\"<\/p>\n

7. Create and publish<\/h3>\n

Finally, click Create, add a few links to further documentation in the online help, and Publish.<\/p>\n

Take a look. This brick key placed the FAQ under a Tweet<\/em>, where you can either reply or send a direct message. What’s the difference? Read the FAQ…embedded in Twitter<\/em>!<\/p>\n

\"\"<\/p>\n

Note the style of the FAQ changed, too. Your development team has complete control over how your embedded FAQ appears in the UI.<\/p>\n

Embed FAQ in 20 minutes or less<\/h2>\n

Yes, it’s really that quick and easy to embed FAQ in software using edc<\/strong><\/em>. We created edc<\/strong> <\/em>to improve the end user experience and to make collaboration among software teams efficient and productive.<\/p>\n

Try the demo<\/a> to see how easily you can embed FAQ in software. Click the HELP icon (?) anywhere in the software to learn more.<\/p>\n

Want more ideas for embedded help? Read More Embedded Help Examples<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

Imagine your users accessing FAQ for your software product right inside the interface. No more searching online documentation for answers to frequently asked questions. For those questions that are so common, shouldn’t they be easy to find? You improve the user experience when you embed FAQ in software. Embed FAQ in Twitter Let’s use a […]<\/p>\n","protected":false},"author":4,"featured_media":4464,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[41],"tags":[45,44],"class_list":["post-4659","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-blog-en","tag-faq-en","tag-user-experience-en"],"yoast_head":"\nImprove User Experience: Embed FAQ in Software | edc<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Improve User Experience: Embed FAQ in Software | edc\" \/>\n<meta property=\"og:description\" content=\"Imagine your users accessing FAQ for your software product right inside the interface. No more searching online documentation for answers to frequently asked questions. For those questions that are so common, shouldn’t they be easy to find? You improve the user experience when you embed FAQ in software. Embed FAQ in Twitter Let’s use a […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/\" \/>\n<meta property=\"og:site_name\" content=\"edc\" \/>\n<meta property=\"article:published_time\" content=\"2020-12-18T08:23:10+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2022-02-14T12:53:27+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.easydoccontents.com\/wp-content\/uploads\/2019\/04\/FAQ-scaled.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"2560\" \/>\n\t<meta property=\"og:image:height\" content=\"1600\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/\"},\"author\":{\"name\":\"\",\"@id\":\"\"},\"headline\":\"Improve User Experience: Embed FAQ in Software\",\"datePublished\":\"2020-12-18T08:23:10+00:00\",\"dateModified\":\"2022-02-14T12:53:27+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/\"},\"wordCount\":707,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.easydoccontents.com\\\/wp-content\\\/uploads\\\/2019\\\/04\\\/FAQ-scaled.jpg\",\"keywords\":[\"faq\",\"user experience\"],\"articleSection\":[\"Blog\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/\",\"url\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/\",\"name\":\"Improve User Experience: Embed FAQ in Software | edc\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.easydoccontents.com\\\/wp-content\\\/uploads\\\/2019\\\/04\\\/FAQ-scaled.jpg\",\"datePublished\":\"2020-12-18T08:23:10+00:00\",\"dateModified\":\"2022-02-14T12:53:27+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.easydoccontents.com\\\/wp-content\\\/uploads\\\/2019\\\/04\\\/FAQ-scaled.jpg\",\"contentUrl\":\"https:\\\/\\\/www.easydoccontents.com\\\/wp-content\\\/uploads\\\/2019\\\/04\\\/FAQ-scaled.jpg\",\"width\":2560,\"height\":1600},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/2020\\\/12\\\/18\\\/improve-user-experience-embed-faq-in-software\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/home\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Improve User Experience: Embed FAQ in Software\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/#website\",\"url\":\"https:\\\/\\\/www.easydoccontents.com\\\/\",\"name\":\"edc\",\"description\":\"easydoccontents\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.easydoccontents.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/#organization\",\"name\":\"edc\",\"url\":\"https:\\\/\\\/www.easydoccontents.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.easydoccontents.com\\\/wp-content\\\/uploads\\\/2020\\\/11\\\/LogoTECH_advantage_noir-2-1.png\",\"contentUrl\":\"https:\\\/\\\/www.easydoccontents.com\\\/wp-content\\\/uploads\\\/2020\\\/11\\\/LogoTECH_advantage_noir-2-1.png\",\"width\":117,\"height\":54,\"caption\":\"edc\"},\"image\":{\"@id\":\"https:\\\/\\\/www.easydoccontents.com\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.linkedin.com\\\/showcase\\\/edc---easy-doc-contents-software\\\/\",\"https:\\\/\\\/www.youtube.com\\\/channel\\\/UCPVgVUy5HMLnknwGwDqLnJw\\\/featured\"]},{\"@type\":\"Person\",\"@id\":\"\",\"url\":\"https:\\\/\\\/www.easydoccontents.com\\\/en\\\/author\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Improve User Experience: Embed FAQ in Software | edc","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/","og_locale":"en_US","og_type":"article","og_title":"Improve User Experience: Embed FAQ in Software | edc","og_description":"Imagine your users accessing FAQ for your software product right inside the interface. No more searching online documentation for answers to frequently asked questions. For those questions that are so common, shouldn’t they be easy to find? You improve the user experience when you embed FAQ in software. Embed FAQ in Twitter Let’s use a […]","og_url":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/","og_site_name":"edc","article_published_time":"2020-12-18T08:23:10+00:00","article_modified_time":"2022-02-14T12:53:27+00:00","og_image":[{"width":2560,"height":1600,"url":"https:\/\/www.easydoccontents.com\/wp-content\/uploads\/2019\/04\/FAQ-scaled.jpg","type":"image\/jpeg"}],"twitter_card":"summary_large_image","twitter_misc":{"Written by":"","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/#article","isPartOf":{"@id":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/"},"author":{"name":"","@id":""},"headline":"Improve User Experience: Embed FAQ in Software","datePublished":"2020-12-18T08:23:10+00:00","dateModified":"2022-02-14T12:53:27+00:00","mainEntityOfPage":{"@id":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/"},"wordCount":707,"commentCount":0,"publisher":{"@id":"https:\/\/www.easydoccontents.com\/#organization"},"image":{"@id":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/#primaryimage"},"thumbnailUrl":"https:\/\/www.easydoccontents.com\/wp-content\/uploads\/2019\/04\/FAQ-scaled.jpg","keywords":["faq","user experience"],"articleSection":["Blog"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/","url":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/","name":"Improve User Experience: Embed FAQ in Software | edc","isPartOf":{"@id":"https:\/\/www.easydoccontents.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/#primaryimage"},"image":{"@id":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/#primaryimage"},"thumbnailUrl":"https:\/\/www.easydoccontents.com\/wp-content\/uploads\/2019\/04\/FAQ-scaled.jpg","datePublished":"2020-12-18T08:23:10+00:00","dateModified":"2022-02-14T12:53:27+00:00","breadcrumb":{"@id":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/#primaryimage","url":"https:\/\/www.easydoccontents.com\/wp-content\/uploads\/2019\/04\/FAQ-scaled.jpg","contentUrl":"https:\/\/www.easydoccontents.com\/wp-content\/uploads\/2019\/04\/FAQ-scaled.jpg","width":2560,"height":1600},{"@type":"BreadcrumbList","@id":"https:\/\/www.easydoccontents.com\/en\/2020\/12\/18\/improve-user-experience-embed-faq-in-software\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.easydoccontents.com\/en\/home\/"},{"@type":"ListItem","position":2,"name":"Improve User Experience: Embed FAQ in Software"}]},{"@type":"WebSite","@id":"https:\/\/www.easydoccontents.com\/#website","url":"https:\/\/www.easydoccontents.com\/","name":"edc","description":"easydoccontents","publisher":{"@id":"https:\/\/www.easydoccontents.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.easydoccontents.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.easydoccontents.com\/#organization","name":"edc","url":"https:\/\/www.easydoccontents.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.easydoccontents.com\/#\/schema\/logo\/image\/","url":"https:\/\/www.easydoccontents.com\/wp-content\/uploads\/2020\/11\/LogoTECH_advantage_noir-2-1.png","contentUrl":"https:\/\/www.easydoccontents.com\/wp-content\/uploads\/2020\/11\/LogoTECH_advantage_noir-2-1.png","width":117,"height":54,"caption":"edc"},"image":{"@id":"https:\/\/www.easydoccontents.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.linkedin.com\/showcase\/edc---easy-doc-contents-software\/","https:\/\/www.youtube.com\/channel\/UCPVgVUy5HMLnknwGwDqLnJw\/featured"]},{"@type":"Person","@id":"","url":"https:\/\/www.easydoccontents.com\/en\/author\/"}]}},"_links":{"self":[{"href":"https:\/\/www.easydoccontents.com\/en\/wp-json\/wp\/v2\/posts\/4659","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.easydoccontents.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.easydoccontents.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.easydoccontents.com\/en\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.easydoccontents.com\/en\/wp-json\/wp\/v2\/comments?post=4659"}],"version-history":[{"count":5,"href":"https:\/\/www.easydoccontents.com\/en\/wp-json\/wp\/v2\/posts\/4659\/revisions"}],"predecessor-version":[{"id":6218,"href":"https:\/\/www.easydoccontents.com\/en\/wp-json\/wp\/v2\/posts\/4659\/revisions\/6218"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.easydoccontents.com\/en\/wp-json\/wp\/v2\/media\/4464"}],"wp:attachment":[{"href":"https:\/\/www.easydoccontents.com\/en\/wp-json\/wp\/v2\/media?parent=4659"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.easydoccontents.com\/en\/wp-json\/wp\/v2\/categories?post=4659"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.easydoccontents.com\/en\/wp-json\/wp\/v2\/tags?post=4659"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}