eclipse-archived / codewind

The official repository of the Eclipse Codewind project
https://codewind.dev
Eclipse Public License 2.0
114 stars 45 forks source link

As a potential customer, I want to see an FAQ section to help me understand Codewind quickly #1226

Open MelHopper opened 4 years ago

MelHopper commented 4 years ago

Description of the enhancement: Many software offerings supply a FAQ section in their documentation early on in the Discovery user journey in order to help a potential customer understand the product and where it sits in terms of their own user cases quickly - see the following for examples:

Content is therefore required to enhance the user experience of both potential and inexperienced Codewind users.

Proposed solution: Create an FAQ section, based on UX testing and advocacy findings to answer the most commonly asked questions and prevent the most common misunderstandings about the product.

This content will sit in the Table of Contents, but will also eventually be exposed explicitly on the Docs Landing Page when we have one.

MelHopper commented 4 years ago

Currently, the 'What is Codewind' section does include basic FAQ, however, input from advocacy and UX is still required, as well as metrics from the website search once that functioned is added (planned for 2Q)

Advocacy: @AndyRWatson @NikCanvin @beccabau - could you take a look at the current 'What is Codewind'?' topic and let me know if you think any other questions should be answered? https://www.eclipse.org/codewind/overview.html