Create FAQs

[AndyClifton]

FAQs help users understand products and services.

We should collect these in one document that can be used on its own, used on the website, and to support marketing activities.

actions

• [x] identify relevant users / actors
• [x] set up basic structure for questions
• [ ] review and edit questions and answers
• [ ] transfer questions to CMS and / or knowledge base
• [ ] Add FAQ management to website maintenance tasks or KB maintenance tasks
• [ ] Add a section for FAQs and component on the site or docs to match.

[thclark]

FAQs content to be captured here. FAQ delivery to clients will be done by creating FAQs in the CMS - see octue/issues#17

[AndyClifton]

Some thoughts on the Octue FAQ, partly based on:

• https://www.socialmediatoday.com/content/10-tips-creating-killer-faq-page
• https://www.searchenginejournal.com/best-faq-page-examples/267709/

Why an FAQ?

The FAQ should help push potential customers towards a purchase or trial. It should reduce the amount of work that we need to do, to convert an enquiry into a sale.

At this time (June 2019) the goal of the FAQ should be to answer the basic newb questions. As our market and users mature, we can review the FAQ concept.

About the FAQ

The FAQ should be a mixture of “management”-level questions (what am I being asked to pay for?) and “worker”-level questions (how do I use this). They should be real, user-oriented questions, not padding.

The answer should provide actionable information, either e.g. a link to a document or more information, or a “mailto…”

The May 2018 proposal from Tom to NPC contains a lot of useful information that could be used to support the FAQ.

Detailed questions about coding will be pushed to a knowledge base system.

Implementing the FAQ

The FAQ should be accessible via www.octue.com.

Answers should also include a thumbs up / down / feedback option (not required on first release!)

[AndyClifton]

First suggested questions, based on questions raised by potential users:

1. How do I implement a Digital Twin on Octue?

A digital twin is a software version of a real-world system or device. So, like in the real world, your digital twin needs inputs about the environment that it works in, and needs to have a model of how the system responds. If you think of a wind plant, the inputs might be wind speed and direction, the system is the power curve, and so the output might be power. In octue you set up your data streams, link to code that describes your system, and serve the output data to whomever needs it. See this demo for an example.

2. Does Octue let me use several data files and real-time data as inputs?
3. Can I share my results with another person or organization?
4. Where will my data be kept?
5. Can I see a demo of setting up a digital twin?
6. Can I get help with creating my digital twin?
7. How can I switch to Octue from another platform?
8. Can I get help with coding issues?
9. What happens if your service providers go down?

[AndyClifton]

See also the "What is Octue" slide deck